APIとは｜アプリやサービスがデータをやり取りする窓口

操作の前後で変わる部分を見てみよう

APIを理解するには、実際の画面で「あとから増えるデータ」を探すのが近道です。

1. 検索、もっと読むなどのボタンを探す
2. 押す前と押した後で、画面のどこが変わるか見る
3. ページ全体が読み直されたのか、一部だけ変わったのかを見る
4. 返ってきた内容が、一覧、メッセージ、保存結果、エラーのどれに近いか分ける
5. 開発者ツールを使える場合は、Networkで追加リクエストが出ているか見る

APIとは、アプリやサービスが＿＿＿＿＿＿＿＿＿＿＿＿ための窓口です。
エンドポイントは、APIの＿＿＿＿＿＿＿＿＿＿＿＿を示します。
APIエラーを見たら、頼み方、認証、通信、＿＿＿＿＿＿＿＿＿＿＿＿を分けて確認します。

答えの例は、「決まった形でデータや機能をやり取りする」「送り先」「サーバー側の処理」です。画面の操作と、裏側のリクエストとレスポンスを対応させて言えるかを確認してください。

ユイ

Webサーバー受付の奥に、API受付という窓口があります

マコト

ページではなく、データを返す窓口として見るとよさそうだね

ピコ

うん。APIは、アプリやサービス同士が決まった形でやり取りするための窓口だよ

ここでは、Webでデータを受け取る場面を例に見ていきます。検索結果をあとから表示する、チャットに新しいメッセージを追加する、地図を動かすと周辺情報を読み込む、といった場面でAPIが関わることがあります。ブラウザやアプリは決められた形でリクエストを送り、サーバー側はデータや処理結果をレスポンスとして返します。

第63話「APIは何を返す？」では、Webサーバー受付の奥にあるAPI受付へ進みます。画面のむこう側で、ページ全体ではなくデータだけが返ってくる場面を見ていきましょう。

受付票のある窓口で頼み方をそろえる

「天気を知りたい」「検索結果を返してほしい」「メッセージを保存したい」「ログイン状態を確認したい」といったお願いを、アプリやサービスは自由な文章ではなく決まった形式で送ります。APIは、そのお願いを受け付け、決まった形で返事を返します。

ラボのたとえでは、APIは受付票のある窓口です。どの窓口へ、どんな条件で、どんな方法でお願いするかが受付票に書かれています。実際にはURL、HTTPメソッド、ヘッダー、認証情報、リクエスト本文、レスポンス本文などが関わる場合があります。APIを受ける側の大きな役割は、Webサーバーとは とつなげると整理しやすくなります。

APIでやり取りするもの

APIでは、完成した画面そのものではなく、画面に使うデータや処理結果が返ることがあります。

たとえば、次のようなものです。

• 検索結果の一覧
• 商品名、価格、在庫数
• チャットのメッセージ
• 地図の周辺情報
• ログイン中のユーザー情報
• 保存が成功したかどうか
• エラーの理由

返ってきたデータを、JavaScriptとは で扱うブラウザ側の動きが画面の部品に入れることがあります。第11話では、APIの現在の返事をJavaScriptへ渡し、古い残席表示を直しました。

APIの返事は、HTMLの完成ページとは限りません。JSONのようなデータ形式で返ることもあります。最初は形式名を暗記するより、「画面の一部を作るためのデータが返ることがある」と見ると入りやすくなります。

1. 画面で操作する
2. ブラウザやアプリがAPIへリクエストを送る
3. APIが条件や認証を確認する
4. データや処理結果をレスポンスで返す
5. 画面の一部が更新される

イト

APIは、ページを丸ごと返す受付とは違うことがあるんだね

ピコ

そう。データだけ返して、画面への並べ方は別の部品が担当する場合があるよ

AIが道具を使うときも、その裏側でAPIへ問い合わせる場合があります。AIのツール呼び出しでは、モデルが依頼を作る部分と、実行側が処理して結果を返す部分を分けて見られます。

AIアプリ向けに、外部の機能を伝えて利用する形式をそろえる仕組みがMCPです。MCPサーバーの裏側で既存のAPIを使うこともあり、APIを置き換えるだけの関係ではありません。

エンドポイントとメソッド

APIも、多くの場合はお願いと返事の形で考えられます。

たとえば検索APIなら、「この言葉で検索して」「10件だけ返して」「新しい順で並べて」といった条件を送ることがあります。保存APIなら、保存したい内容を本文として送ることがあります。

同じAPIでも、仕様によって頼み方は変わります。実際に使うときは、どのURLに送るのか、どのメソッドを使うのか、何を送る必要があるのか、どんな返事が返るのかを確認します。

レスポンスとJSON

APIのレスポンスには、データが入っていることがあります。

Webページの材料としてHTMLが返る場面もありますが、APIではJSONという形式でデータが返ることがよくあります。JSONは、名前と値の組み合わせなどでデータを表す形式です。人間にも機械にも読みやすい形なので、アプリやブラウザが受け取って画面に反映しやすくなります。

たとえば、商品一覧なら商品名、価格、画像のURL、在庫数などが返る場合があります。チャットなら、メッセージ本文、送信者、時刻などが返るかもしれません。

大切なのは、APIの返事は「画面にどう見せるか」まで全部決めているとは限らないことです。APIがデータを返し、JavaScriptやアプリ側がそのデータを表示用の部品に入れる、という分担になる場合があります。

認証とエラー

APIには、誰でも使えるものと、認証が必要なものがあります。

ログイン中のユーザー情報を返すAPI、注文履歴を返すAPI、管理画面の保存APIなどは、誰が使ってよいかを確認する必要があります。そこでCookie、トークン、APIキーのような情報が関係する場合があります。

APIエラーという言葉も、ただ「壊れた」という意味ではありません。

• 必要な情報が足りない
• 認証が通っていない
• 権限が足りない
• 頼んだデータが見つからない
• 入力形式が合っていない
• サーバー側で失敗している
• 通信が途切れている

エラーを見たときは、頼み方、認証、通信、サーバー側の処理、返ってきたエラー内容を分けて確認します。画面に出る短いメッセージだけで決めつけず、どの段階で止まったのかを探すのが近道です。

APIが画面に現れる場面

APIは、画面の外にあるデータや機能とつながる場面でよく出てきます。

身近な例では、次のようなものがあります。

1. 検索フォームに入力して結果を表示する
2. もっと読むボタンで記事一覧を追加する
3. 天気アプリが今日の天気を取得する
4. 地図アプリが周辺のお店を表示する
5. チャットアプリが新しいメッセージを受け取る
6. 管理画面で保存ボタンを押して結果を表示する

画面では一つの操作に見えても、裏側ではJavaScriptがAPIへリクエストを送り、返ってきたデータを画面に反映していることがあります。

開発者ツールを使える場合は、Networkで追加のリクエストを見ると手がかりになります。全部を読めなくても、操作をきっかけに画面のむこう側へお願いが出ていることがわかれば十分です。

APIを使うときの注意点

APIは便利ですが、使い方には注意が必要です。

まず、必要以上に何度もリクエストを送ると、画面が遅くなったり、サービス側に負荷がかかったりすることがあります。検索欄に一文字入力するたびに毎回APIに送るなら、送るタイミングを工夫する必要が出る場合があります。

次に、大事な情報の扱いです。APIキーやトークンのような認証情報を、誰でも見える場所に置いてよいとは限りません。どこまでブラウザ側に置いてよいか、サーバー側で隠すべきかは、サービスの設計によって変わります。

最後に、返事が遅いときや失敗したときの画面です。読み込み中の表示、再試行、エラーメッセージなどを考えておくと、利用者は何が起きているのか理解しやすくなります。

ミニクイズ：お願いと返事を確かめる

Q1. APIを一文でいうと？

APIは、アプリやサービス同士が決まった形でデータや機能をやり取りするための窓口です。

Q2. APIの返事は完成した画面だけですか？

いいえ。検索結果やメッセージのような、画面の一部に使うデータが返ることもあります。

Q3. APIエラーを見たら、まず何を分けますか？

頼み方、認証、通信、サーバー側の処理、返ってきたエラー内容を分けて確認します。