はじめに
Web開発をしていると「API」という言葉をよく聞きます。
- Google Maps API
- Twitter API
- ChatGPT API
など、さまざまなサービスでAPIが使われています。
しかし、最初は
「APIって結局なに？」
「なんとなく使っているけど説明できない」
という人も多いのではないでしょうか。
この記事では、APIの基本を初心者向けにわかりやすく解説します。
私自身もAPIをきちんと理解するために、整理しながら説明していきます。
APIを一言でいうと
APIを一言でいうと
「システム同士がやり取りするための窓口」
です。
アプリやシステムは、APIを通して
- データを取得する
- データを送る
といったやり取りを行います。
つまりAPIは、システム同士をつなぐ橋のような存在です。
APIをレストランで例えると
APIはレストランで例えると、とても理解しやすくなります。
登場人物は3つです。
- お客さん
- ウェイター
- 厨房
それぞれをシステムに置き換えるとこうなります。
| レストラン | システム |
|---|---|
| お客さん | アプリ |
| ウェイター | API |
| 厨房 | サーバー |
流れはこうです。
①お客さんが料理を注文する
②ウェイターが厨房に伝える
③厨房が料理を作る
④ウェイターがお客さんに料理を届ける
このウェイターの役割がAPIです。
アプリは直接サーバーとやり取りするのではなく、
APIを通してデータを受け取ります。
APIはなぜ必要なのか
APIがあることで、システムは
他のサービスの機能を利用できるようになります。
例えば、
- 地図を表示する → Google Maps API
- 決済する → 決済API
- 天気を表示する → 天気API
もしAPIがなければ、
- 地図システム
- 決済システム
- 天気データ
などをすべて自分で作る必要があります。
APIのおかげで、既存のサービスを簡単に利用できるのです。
APIの具体例
例えば、天気アプリを作るとします。
天気情報は気象サービスのAPIから取得できます。
アプリはAPIに対して
「東京の天気を教えて」
とリクエストを送ります。
するとAPIが
{
"city": "Tokyo",
"weather": "sunny",
"temperature": 26
}のようなデータを返してくれます。
アプリはこのデータを使って、画面に天気を表示します。
Web開発でよく使うAPI
Web開発では様々なAPIが使われています。
例えば次のようなものがあります。
- Google Maps API（地図表示）
- YouTube API（動画データ取得）
- Twitter API（ツイート取得）
- ChatGPT API（AI機能）
最近のWebサービスは、多くのAPIを組み合わせて作られています。
APIの簡単な仕組み
APIは基本的に次の流れで動きます。
①クライアント（アプリ）がリクエストを送る
②サーバーが処理する
③APIがデータを返す
よくあるリクエストの例
GET /api/usersこれは
「ユーザー一覧をください」
という意味になります。
そしてサーバーは次のようなデータを返します。
[
{ "id": 1, "name": "Tanaka" },
{ "id": 2, "name": "Suzuki" }
]このようにして、アプリはデータを取得しています。
まとめ
APIとは
システム同士がデータをやり取りするための窓口
です。
APIを使うことで
- 他のサービスの機能を利用できる
- 開発を効率化できる
- サービス同士を連携できる
といったメリットがあります。
最初は少し難しく感じるかもしれませんが、
「システム同士をつなぐ窓口」
と考えると理解しやすいと思います。
