APIとは

APIとは、あるソフトウェアが持つ機能やデータを、別のプログラムから決まった手順で呼び出すための窓口と約束事のことです。Application Programming Interface の頭文字で、「えーぴーあい」と読みます。

人が画面のボタンを押して使う入口がユーザーインターフェースだとすると、APIはプログラムが使う入口です。MDN Web Docs の用語集でも、APIは人間向けのユーザーインターフェースと対になるものとして説明されています。

呼び出す側は、相手の中身がどう作られているかを知らなくても使えます。「この形で頼めば、この形で返す」という約束だけを守ればよいからです。ブラウザーの位置情報の機能や、OSのファイル操作も、プログラムから見ればAPIの一種です。

AI開発でよく扱うのは、インターネット越しに呼び出すWeb APIです。多くはHTTPという通信の決まりの上で、リクエストとレスポンスを1往復させて動きます。要素の一覧はHTTP の概要（MDN Web Docs）にまとまっています。

• リクエスト：メソッド（取得なら GET、送信なら POST など）、宛先のパス、ヘッダー、必要なら本体を送ります。認証に使うAPIキーは、ヘッダーに入れる形がよく見られます。
• レスポンス：ステータスコード、ヘッダー、本体が返ります。本体はJSONで書かれていることが多いです。

成否はステータスコードの百の位で読めます。2xxは成功、4xxは送った側の問題、5xxは受けた側の問題です。401は認証が通っていない、403は相手が誰かは分かったうえで権限がない、429は短い時間に送りすぎた、という意味です。詳しい一覧はHTTP レスポンスステータスコード（MDN Web Docs）で引けます。

生成AIのAPIで文章の要約を頼む場面を例にします。自分のアプリの中では、次の順で処理が進みます。

• 要約したい文章と使うモデルの名前を JSON にまとめ、POST で送る
• ヘッダーに、発行済みのAPIキーを付ける
• 返ってきた JSON から、生成された文章の部分だけを取り出して画面に出す

AIコーディングエージェントに「このAPIで機能を作って」と頼むこともできます。その場合は、提供元の仕様書（APIリファレンス）のURLや該当部分を一緒に渡すのがよいと考えます。エージェントは古い書き方を覚えていることがあり、仕様書を渡すと食い違いが減るからです。

モデルが外部の道具を呼び出す関数呼び出しやMCPも、最終的にはこうしたAPIの呼び出しにつながっています。

• 誤解：APIはWebサービスのことだけを指す → 実際：ライブラリの関数やOSの機能など、プログラムから使う入口全般をAPIと呼びます。Web APIはその一部です。
• 誤解：APIとSDKは同じもの → 実際：APIは約束事そのもので、SDKはそれを呼びやすくする道具のまとまりです。SDKを入れなくても、HTTPで直接送れば同じAPIを呼べます。
• 誤解：200が返れば結果も正しい → 実際：200は依頼が受け付けられ、処理が済んだことを示すだけです。本体に期待した項目がそろっているかは、別に確かめます。

• エラー時も本体を読む：4xxや5xxのときも、本体に理由が書かれていることがよくあります。コードの数字だけで判断せず、本文も記録に残します。
• 429のあとは間を空ける：すぐに送り直すと制限が続きます。待ち時間を少しずつ延ばして送り直すのが一般的な対処です。上限の考え方はレートリミットのページにまとめています。
• 料金の上限を先に決める：生成AIのAPIは、使った量に応じて料金がかかる料金体系が多く見られます。試す前に、利用上限を設定できるかを確かめておきます。
• キーをコードに書かない：APIキーは環境変数から読み込みます。

• SDK
• 関数呼び出し（ツール使用）
• MCP（モデルコンテキストプロトコル）
• フロントエンド/バックエンド
• CLI
• APIキー
• JSON
• レートリミット
• Webhook

• AIエージェントのツール呼び出し設計チェックリスト15項目と失敗例
• AIコーディングエージェントの料金を抑える使い方
• MCPとは？AIエージェントとツール連携の仕組み

• API - 用語集（MDN Web Docs）
• HTTP の概要（MDN Web Docs）
• HTTP レスポンスステータスコード（MDN Web Docs）

Q1. APIとは何ですか？
あるソフトウェアの機能やデータを、別のプログラムから決まった手順で呼び出すための窓口と約束事のことです。人が操作する画面とは別に用意された、プログラム専用の入口と考えると分かりやすくなります。

Q2. APIを使うにはプログラミングが必要ですか？
呼び出すには、リクエストを組み立てて送る手段が要ります。コードを書くのが一般的ですが、curl のようなコマンドで1回だけ試すこともできます。呼び出し部分をAIコーディングエージェントに書かせる場合も、送る内容と返る内容は自分で確かめます。

Q3. APIを呼んだら401が返ってきました。原因は何ですか？
認証が通っていないという意味です。APIキーの貼り間違い、前後の空白の混入、ヘッダー名の書き違い、キーの失効がよくある原因です。403の場合は、相手が誰かは分かっているものの、その操作の権限がないことを示します。

Q4. APIとSDKの違いは何ですか？
APIは「どう頼めば何が返るか」という約束事で、SDKはその約束に沿った呼び出しを楽にするためのライブラリや道具のまとまりです。SDKは内部でAPIを呼んでいるので、使わずにHTTPで直接送ることもできます。

Q5. 無料で使えるAPIはありますか？
無料枠を設けているサービスや、登録なしで使える公開APIもあります。ただし条件はサービスごとに違い、途中で変わることもあります。利用規約と料金のページで、上限と超えたときの扱いを確かめてから使います。