新規ページ

🔌 APIの基本とは？

API（エーピーアイ）とは Application Programming Interface の略で、 **アプリケーション同士が情報をやり取りするための「窓口」**のような存在です。

---

🧩 APIが必要な理由

現代のソフトウェア開発では、すべての機能を1つのアプリ内で作るのではなく、 他のサービスと連携して効率化するのが主流です。 たとえば：

• 天気情報を取得する（→天気API）
• 支払いを行う（→決済API）
• ログインをGoogleアカウントで行う（→OAuth API）

---

🏗️ APIの種類

1. Web API（HTTP経由）

インターネットを介してアクセスするAPI。 スマホアプリやフロントエンドとサーバのやり取りはここがメイン。

• REST API（代表的、今もっとも広く使われている）
• GraphQL（Facebook発、柔軟なクエリが特徴）
• gRPC（Google発、バイナリ高速通信）

2. ローカルAPI

OSやライブラリ内部でのやり取り。 たとえばWindowsのアプリが「ファイルを開く」処理をするとき、OSに対してAPIを呼び出している。

---

🧭 APIの構成要素（Web APIを例に）

APIを使うときは、以下の4つを意識することが多いです：

• エンドポイント：アクセスするURL（例：https://api.example.com/items）
• メソッド：HTTPの種類（例：GET, POST）
• リクエストパラメータ：何を送るか
• レスポンス：サーバから返ってくる結果（JSONなど）

---

🗺️ エンドポイントとは？

エンドポイントとは「APIへの入り口となるURL」のことです。
見た目は普通のWebアドレス（URL）と似ていますが、「人が見るためのWebページ」ではなく、プログラムがデータをやり取りするための場所です。

【例】
WebサイトのURL（人間が見る用）
→ https://example.com/products.html
APIのエンドポイント（アプリが使う用）
→ https://api.example.com/products

エンドポイントは「この場所にアクセスすればデータを送ったり受け取ったりできますよ」という住所のようなものです。
Webサイトが「ページの入り口」なら、APIのエンドポイントは「データの入り口」と考えるとわかりやすいです。

---

🧪 具体例で理解するエンドポイント

たとえば、「商品一覧を取得するAPI」があるとします。

 GET https://api.shop.com/products
 

このURLがエンドポイントになります。ここにアクセスすることで「商品データ」がJSON形式で返ってきます。