APIって何? サービスどうしのやり取りを「レストランの注文」で説明します

執筆:
三橋 遥香
エンジニア
公開
読了時間
8分で読めます
Share

「このツールはAPIでつながっています」「APIキーを入れてください」と言われても、何が起きているのかは見えにくいものです。APIを、会員制レストランの注文窓口にたとえて、メニュー(仕様)、注文票と料理(リクエストとレスポンス)、合鍵(APIキー)、断られるとき(エラーと回数の制限)を、まんがの挿絵で説明します。コマンドやコードには踏み込みません。

POINT

APIは、サービスが外からの頼みごとを受けるための注文の窓口と、その頼み方の決まりです。頼む側は注文票(リクエスト)を出し、料理(レスポンス)を受け取ります。APIキーは窓口を使うための合鍵で、サービスはこれで誰からの注文かを確かめ、使った分をそのキーが属するアカウントの利用量として数えます。

2026年11月17日に各社の公式資料とHTTPの仕様の解説を確認。レストランのたとえは説明のための一例です。回数の上限はサービスや利用の段階によって異なります。当社による実測は行っていません。

AIツールやアプリの説明で、「このツールはAPIでほかのサービスとつながっています」「APIキーを入れてください」と書かれていることがあります。APIという言葉は聞いたことがあっても、裏で何が起きているのかは見えにくいものです。

この記事では、APIをレストランの注文の窓口にたとえて説明します。お店に当たるのは、データや機能を持っているサービスです。注文に行くのはロボットで、これはAPIを使うアプリやAIの役です。女の子は、ロボットにお使いを頼む人で、合鍵(APIキー)の持ち主です。

厨房に勝手に入られたら困る

レストランの壁に「厨房」の札が下がった扉があり、中に入ろうとしたロボットを、白いコック帽の料理人が手のひらを向けて止めている。扉の奥には鍋や包丁が見える。料理人はもう片方の手で、「注文窓口」の札が掛かった壁の小窓を指し、女の子もその窓を指さしている。

レストランの厨房には、火にかけた鍋や包丁があり、材料の置き場所や料理を作る順番も決まっています。お客さんが勝手に入って料理を始めたら、危ないうえに、お店の仕事が回らなくなります。だからレストランには、注文を受けるための窓口があります。お客さんは窓口で頼み、厨房の中のことはお店に任せます。

サービスどうしのやり取りも、この記事では同じように考えます。外のプログラムが中に入ってデータや機能にじかに触れたら、壊したり、見せてはいけないものまで見たりしかねません。外から頼んでよいことと、その頼み方を決めた窓口が、API(Application Programming Interface)です。Webの技術を解説する MDN は、APIを、ソフトウェアの中にある機能と決まりの集まりで、ほかのソフトウェアがそれを通じてやり取りできるようにするもの、と説明しています。この記事では、インターネットを通じて使うAPI(Web API)を例にします。

たとえで説明しきれない点もあります。APIの窓口の向こうにいるのは、料理人ではなくプログラムです。注文を読むのも、返事を返すのも、決まりに沿って動くプログラムなので、決まりから外れた頼み方は断られます(断られ方は後で説明します)。

APIとAPIキーは別もの

先に、混同しやすい2つを分けておきます。

  • API:注文の窓口と、その頼み方の決まり。お店(サービス)の側が用意するもの
  • APIキー:このお店は会員制で、会員ごとに作った合鍵が会員証の代わりです。その合鍵に当たるのがAPIキーで、使う側が持つもの

設定の画面で「APIキーを入れてください」と言われたら、入れるのは合鍵のほうです。窓口(API)そのものは、お店の側にあります。APIキーを合鍵にたとえるのは、その鍵、どこに残る? AIのチャットやGitHubに鍵を書いてはいけない仕組みと同じです。

メニュー(APIの仕様)

レストランの壁に「メニュー」と書かれた大きな板が掛かっていて、カレーライス・オムライス・ラーメン・ハンバーグの絵が並ぶ。下の段は「頼み方」の欄で、大きいどんぶりと小さいどんぶり、3本の唐辛子が描かれている。女の子が板を指さし、ロボットが横で見上げていて、窓の中の料理人がにこにこしている。

窓口の横には、メニューが貼ってあります。頼める料理と、その頼み方が書いてあり、メニューにないものは頼めません。

APIにも、このメニューに当たるものがあります。どんな頼みごとができて、そのとき何を伝えればよく、何が返ってくるかを書いたもので、APIの仕様と呼ばれます。書き方の標準もあります。たとえば OpenAPI という標準は、ソースコードを見なくても、人とコンピューターの両方が、そのサービスにできることを知り、理解できるようにするためのものだと説明されています。厨房の中を見なくても、メニューを読めば頼み方が分かる、というわけです。

たとえで説明しきれない点があります。レストランのメニューに並ぶのは料理ですが、APIのメニューに並ぶのは、サービスにしてほしい頼みごとです。頼む側がアプリやAIなので、メニューも、人が眺めるためだけでなく、プログラムが読み取れる形で書かれることがあります。

注文票と料理(リクエストとレスポンス)

レストランの壁の小窓で、ロボットが「注文票」と書かれた紙を料理人に差し出し、料理人は窓からカレーライスの皿をロボットへ返している。料理人の吹き出しには「おまたせ」。ロボットと窓のあいだを、注文票が入っていく矢印と料理が出てくる矢印が輪のように回っていて、女の子は後ろでうれしそうに見ている。

注文に行くのはロボットです。ロボットは、メニューに沿って注文票を書き、窓口に出します。厨房で料理ができると、窓口から料理が返ってきます。ロボットは厨房に入らず、窓口を通るのは注文票と料理だけです。

注文票に当たるものをリクエスト(request)、返ってくる料理に当たるものをレスポンス(response)と呼びます。MDN は、頼む側(クライアント)がリクエストを送り、サーバーがそれを処理して、答えとしてレスポンスを返す、と説明しています。注文票を出して料理を受け取る、この1往復が、APIでのやり取りの基本の形です。

たとえで説明しきれない点もあります。返ってくるのは料理ではなく、データです。そして、注文が通らなかったときにも、レスポンスは返ってきます。「作れません」という返事も、1往復のうちです。これは後の「断られるとき」で説明します。

合鍵(APIキー)

「会員制」の札が掛かったレストランの窓口で、ロボットが「合鍵」と書かれた札の付いた鍵を見せている。料理人は会員の顔が並んだ帳面を開いて見せ、うなずいている。少し離れて、女の子が手を振っている。

このお店は会員制です。窓口で合鍵を見せると、お店の人は会員の帳面と照らし合わせて、誰の注文かを確かめます。料理の代金は、その会員の勘定につけておきます。

APIキーは、この合鍵です。Anthropic(Claude)や OpenAI のAPIでは、リクエストにAPIキーを添えて送ります。サービスはそのキーで、どのアカウントからの注文かを確かめ、使った分を、そのアカウント(OpenAI では組織とプロジェクト、Anthropic ではワークスペース。請求は組織でまとめます)の利用量として数えます。

ロボットが合鍵を持っていれば、女の子が付き添わなくても注文できます。裏を返すと、お店で合鍵を拾った人も、会員のふりをして注文できてしまいます。勘定は、その合鍵の会員につきます。APIキーでも同じことが起きかねない、というのがこの記事の見方です。OpenAI は、APIキーは秘密であり、人に渡したり、ブラウザや、利用者の手元で動くアプリのコードに置いたりしないよう求めています。Anthropic も、ブラウザで動くページにキーを書くと、ページを使う誰もが読めると説明しています。鍵がどこに写しを残しうるかは、鍵の記事で説明しています。

たとえで説明しきれない点があります。本物のお店なら、顔を見て「いつもの人と違う」と気づけることもありますが、APIの窓口に見せるのは、顔ではなく合鍵です。有効な合鍵が無ければ、注文は断られます(401)。だから、落とした合鍵は早く無効にする必要があります。Anthropic も、漏れた疑いのあるキーは無効にするか消すよう求めています。

断られるとき(エラーと回数の制限)

窓口の前の4つの小さな場面。ピザにアイスをのせた絵の注文に料理人が両手を振る「メニューにない」、ロボットの鍵に赤い×が付き料理人が腕で×を作る「鍵が違う」、ロボットが押し出す注文票の山に料理人が汗をかいて手のひらを向ける「頼みすぎ」、料理人たちが忙しく動く厨房の窓に「満席」の札が下がり、ロボットが目を回している「満席」。

注文しても、料理が出てこないことがあります。そのとき返事が届けば、理由を表す番号が付いています。APIのレスポンスには、うまくいったかどうかを表す3けたの番号が付いていて、これをステータスコードと呼びます。400番台は頼む側に問題があるとき、500番台はサービスの側に問題があるときの番号です。たとえば、次のような断られ方があります。たとえと番号で並べます。

  • メニューにない(404):頼んだものが見つからない
  • 鍵が違う(401):有効な合鍵を持っていない
  • 頼みすぎ(429):決まった時間の中で、注文を出しすぎた
  • 満席(503):お店の側が手いっぱいか、休んでいて、注文を受けられない

このうち「頼みすぎ」は、レート制限(rate limit)と呼ばれる仕組みによるものです。Anthropic(Claude)や OpenAI のAPIには、1分あたりに受け付けるリクエストの数や量に上限があり、超えると429のエラーが返ります。返事に、どれだけ待てばよいかが書かれていれば、その時間待ってから頼み直します。上限の大きさは、サービスや利用の段階によって違います。

たとえで説明しきれない点もあります。レストランなら、お店の人が事情を話してくれますが、APIの返事で手がかりになるのは、番号と、添えられた短い説明です。番号を手がかりに、合鍵を直すのか、待つのか、頼み方を直すのかを考えるのは、頼む側の仕事です。

たとえと実際の言葉

たとえ 実際の言葉 していること
レストラン サービス(サーバー) データや機能を持ち、頼まれた仕事をする
厨房 サービスの内部 外から直接は触らせない部分
注文の窓口 API 外から頼んでよいことと、その頼み方を決めた入口
メニュー APIの仕様 頼めることと頼み方、返ってくるものを書いたもの
注文に行くロボット APIを使うアプリやAI(クライアント) リクエストを送る側
お使いを頼む女の子 利用者(APIキーの持ち主) APIキーを作る。使った分は、そのキーが属するアカウントの利用量になる
注文票 リクエスト(request) 頼みごとを決まった形で送る
料理 レスポンス(response) 頼みごとへの返事。データや結果が入る
会員制の店の合鍵 APIキー 誰からの頼みかを示す。サービスはこれで確かめ、使った分をそのアカウントの利用量として数える
断りの返事 エラー(ステータスコード) 頼みが通らなかった理由を番号で知らせる
「頼みすぎ」の断り レート制限(rate limit) 決まった時間に受け付ける量の上限

AIがAPIを使うとき、人がすること

家の門の前で、女の子が人さし指を立てながら、ロボットに「この店だけ」と書かれた札の付いた鍵と、「ここまで」と書かれた札の付いたがま口を手渡している。ロボットは敬礼していて、後ろにはいくつかのお店が並ぶ通りが続いている。

AIにも、APIを使わせることができます。Anthropic(Claude)や OpenAI のAPIには、AIに道具を使わせる仕組みがあります。開発者が用意した道具の場合、AIは「この窓口に、こう注文したい」という注文票を書いて返し、実際に窓口へ注文を出して料理を受け取るのは、AIを組み込んだアプリの側です。絵のロボットは、このAIとアプリをひとまとめにした役です。なお、AIに使わせる道具は、ほかのサービスのAPIとは限らず、アプリの中の機能のこともあります。

ここからは、この記事の考えです。ロボットにお使いを頼むなら、何をどこまで任せるかは、頼む人が決めることです。

  • どの店に行かせるか:使わせるAPIを、その仕事に要るものだけにします
  • どこまで頼ませるか:読むだけでよい仕事なら、読むことしかできない合鍵を渡します。サービスによっては、合鍵で使える範囲や有効期限を絞れます。たとえば GitHub の、細かく権限を決められるトークン(APIキーと同じ役目の鍵)は、使えるリポジトリ(プログラムの置き場所)と権限を絞り、有効期限を決めて作れます
  • いくらまで使わせるか:使った分は、合鍵が属するアカウントの勘定につきます。Anthropic(Claude)や OpenAI のAPIでは、利用額の上限を自分で決めておけます
  • 合鍵を預けっぱなしにしない:使わなくなった合鍵は無効にし、どこかに写しが残ったかもしれない合鍵は、無効にして作り直します

APIは、サービスどうしが厨房に入らずに頼みごとをするための窓口です。「APIでつながっています」と言われたら、どのお店の窓口に、誰の合鍵で、どこまで頼んでいるのかを考えてみてください。

用語

API(Application Programming Interface)
ソフトウェアがほかのソフトウェアからの頼みごとを受けるための、機能と決まりの集まり。この記事では注文の窓口にたとえています。
APIの仕様
APIでどんな頼みごとができ、何を伝えればよく、何が返ってくるかを書いたもの。OpenAPI のような書き方の標準があります。
リクエスト(request)
頼む側がサービスへ送る頼みごと。この記事では注文票にたとえています。
レスポンス(response)
リクエストに応えてサービスが返すもの。うまくいかなかったときも、理由を表す番号つきで返ってくることがあります。
APIキー
APIを使うときにリクエストに添える秘密の文字列。サービスはこれで、どのアカウントからの頼みかを確かめます。この記事では会員制の店の合鍵にたとえています。
ステータスコード
レスポンスに付く3けたの番号。頼みごとがうまくいったか、うまくいかなかったならどちらの側の問題かを表します。
レート制限(rate limit)
決まった時間の中で受け付けるリクエストの数や量の上限。超えると「頼みすぎ」を表すエラーが返ります。

よくある質問

APIとAPIキーは何が違うのですか?

APIはサービスの側が用意する注文の窓口と、その頼み方の決まりです。APIキーは、その窓口を使う人が持つ合鍵です。設定の画面で入力を求められるのは、合鍵のほうのAPIキーです。

APIキーを人に見せてはいけないのはなぜですか?

サービスはAPIキーで誰からの注文かを確かめ、使った分をそのキーが属するアカウントの利用量として数えるからです。拾われた合鍵で、持ち主のふりをして注文されかねない、というのがこの記事の見方です。OpenAI は、APIキーは秘密であり、人に渡したり、ブラウザや、利用者の手元で動くアプリのコードに置いたりしないよう求めています。

「頼みすぎ」のエラーが出たら、どうすればよいですか?

決まった時間の中で受け付ける量の上限(レート制限)を超えたことを表しています。返事に、どれだけ待てばよいかが書かれていれば、その時間待ってから頼み直します。

参考資料

この記事は、次の一次情報に基づいています。数値や記述の詳細は各資料をご確認ください。

参考資料 16 件を表示
  1. API - Glossary
    MDN Web Docsdeveloper.mozilla.org確認

    APIは、ソフトウェアの中にある機能と決まりの集まりで、ほかのソフトウェアがそのソフトウェアとやり取りできるようにするもの。

  2. Overview of HTTP
    MDN Web Docsdeveloper.mozilla.org確認

    頼む側(クライアント)が送るものをリクエスト、サーバーが答えとして返すものをレスポンスと呼ぶ。リクエストはサーバーへ送られ、サーバーが処理してレスポンスを返す。

  3. OpenAPI Specification v3.2.1
    OpenAPI Initiativespec.openapis.org確認

    HTTPのAPIを書き表す標準。ソースコードを見なくても、人とコンピューターの両方がサービスにできることを知り、理解できるようにする。

  4. Authentication
    Anthropicplatform.claude.com確認

    APIキーは管理画面で作る秘密の値で、リクエストごとに送る。キーは利用者・サービス用のアカウント・ワークスペースのいずれかに属する。ブラウザで動くページにキーを書くと、ページを使う誰もが読める。漏れた疑いのあるキーは無効にするか消す。

  5. Workspaces
    Anthropicplatform.claude.com確認

    ワークスペースは組織の中に作り、請求は組織でまとめる。リクエストが、どのワークスペースの利用量・費用・レート制限として数えられたかを確かめられる。ワークスペースごとに月の利用額の上限を決められる。

  6. API Overview
    OpenAIdevelopers.openai.com確認

    OpenAIのAPIはAPIキーで認証する。リクエストの利用は、指定した組織とプロジェクトの利用として数えられる。APIキーは秘密であり、人に渡したり、ブラウザやアプリなど利用者の側で動くコードに置いたりしない。

  7. HTTP response status codes
    MDN Web Docsdeveloper.mozilla.org確認

    ステータスコードは、リクエストがうまくいったかを表す。100番台から500番台までの5つに分かれ、400番台は頼む側の問題、500番台はサーバーの側の問題を表す。

  8. 401 Unauthorized
    MDN Web Docsdeveloper.mozilla.org確認

    有効な認証の情報が無いために、リクエストが失敗したことを表す。

  9. 404 Not Found
    MDN Web Docsdeveloper.mozilla.org確認

    頼まれたものをサーバーが見つけられないことを表す。

  10. 429 Too Many Requests
    MDN Web Docsdeveloper.mozilla.org確認

    決まった時間の中でリクエストを送りすぎたことを表し、レート制限と呼ばれる。どれだけ待てばよいかを示す情報が付くことがある。

  11. 503 Service Unavailable
    MDN Web Docsdeveloper.mozilla.org確認

    サーバーがリクエストを受ける準備ができていないことを表す。よくある原因は、保守のための停止や、処理が追いつかないほど混んでいること。

  12. Rate limits
    Anthropicplatform.claude.com確認

    1分あたりのリクエスト数やトークン数に上限があり、超えると429のエラーが返る。待つ秒数が示されていれば、その時間待ってから頼み直す。上限は利用の段階(tier)で変わり、利用額の上限を自分で決められる。

  13. Rate limits
    OpenAIdevelopers.openai.com確認

    1分あたりのリクエスト数やトークン数などに上限があり、超えると429のエラーが返る。上限は組織とプロジェクトの単位で決まり、利用の段階(tier)で変わる。利用額の上限を自分で決められる。

  14. Tool use with Claude
    Anthropicplatform.claude.com確認

    開発者が用意した道具の場合、Claudeは道具を呼び出す依頼を決まった形で返し、実際に動かして結果を返すのはアプリの側のコード。Anthropicの側で動く道具(Web検索など)もある。

  15. Function calling
    OpenAIdevelopers.openai.com確認

    モデルが関数の呼び出しを求めたら、アプリの側でそれを実行し、結果をモデルへ返す。

  16. Managing your personal access tokens
    GitHubdocs.github.com確認

    fine-grained personal access token は、使えるリポジトリと権限を絞って作れる。作るときに有効期限を選ぶ。

この記事を引用する

三橋 遥香「APIって何? サービスどうしのやり取りを「レストランの注文」で説明します」株式会社フィールフロウ、2026年11月17日、https://feelflow.net/blog/2026-11-api-restaurant-order/

この記事を書いた人

三橋 遥香

エンジニア

この著者の記事を見る

次に読む

同じトピック:やさしく解説その鍵、どこに残る? AIのチャットやGitHubに鍵を書いてはいけない仕組みClaude Code や Codex のチャットに API キーを書くと、なぜ「漏洩」と言われるのか。GitHub に置くと何が起きるのか。鍵の文字がどこへ運ばれ、どこに残るのかという流れで、通信の暗号化が守ってくれる範囲と守れない範囲、消すのではなく作り直す理由、正しい渡し方を、挿絵つきで解説します。