APIの仕組み

API（エーピーアイ）は Application Programming Interface（アプリケーション・プログラミング・インターフェース）の略称です。正式名称を聞いても「何のこと？」と思いますよね。

まずは日常のたとえで考えてみましょう。レストランに行った場面を想像してください。

あなた（お客さん）は、厨房に直接入って料理を作ることはできません。厨房のルールも、調理器具の使い方も知りません。でも、ウェイターに「パスタをください」と注文すれば、厨房で作られた料理があなたのテーブルに届きます。厨房の中で何が起きているかを知る必要はありません。

この比喩がAPIの本質をほぼ言い当てています。あなた（アプリ）は、厨房（サーバー）の中で何が起きているかを知る必要がありません。ウェイター（API）に決まった形式で注文を伝えれば、結果が返ってくる。これがAPIです。

レストランのたとえで、ざっくりとしたイメージはつかめましたか？ ここからもう少しだけ正確に説明します。

APIとは、ひとことで言えば「ソフトウェア同士が会話するための窓口」です。あなたが使っているアプリの裏側で、別のサービスのデータや機能を借りてくるための「取り決め」と考えてください。

これだけだとまだ抽象的に感じるかもしれません。では、APIがある世界とない世界を比べてみましょう。

APIでのやり取りは、実はとてもシンプルです。基本は「聞く（リクエスト）」と「答える（レスポンス）」の2つだけ。

リクエスト（Request）とは、「こういう情報をください」「この処理をしてください」とAPIに送るメッセージのことです。レスポンス（Response）は、APIがその要求に対して返す結果です。この2つのやり取りを分解すると、4つのステップになります。

言葉だけだとまだピンとこないかもしれません。では、実際のコードで見てみましょう。たとえば、天気予報APIから東京の天気を取得するコードは、たったこれだけです。

// 1. APIにリクエストを送る（「東京の天気を教えて」と聞く）
const response = await fetch("https://api.weather.example.com/current?city=tokyo");

// 2. レスポンスをJSON形式（データの構造）に変換する
const data = await response.json();

// 3. 必要なデータを取り出して使う
console.log(data.temperature); // → "22°C"
console.log(data.condition);   // → "晴れ"
console.log(data.humidity);    // → "65%"

ターミナル（コマンドを入力する黒い画面）からもAPIを試せます。curl（カール）というコマンドを使うと、たった1行でAPIにリクエストを送れます。

$ curl https://api.weather.example.com/current?city=tokyo

# 返ってくるレスポンス（JSON形式）
{
  "city": "東京",
  "temperature": "22°C",
  "condition": "晴れ",
  "humidity": "65%"
}

では、このAPIのレスポンスが実際のアプリではどう表示されるのでしょうか？ あなたが見ている天気アプリの画面を覗いてみましょう。

「API」と聞くとプログラマーの専門用語に聞こえるかもしれません。しかし、あなたがスマホで何気なくやっている日常の操作の裏側では、たくさんのAPIが動いています。「あなたが見ている画面」の裏側で、APIが何をしているのかを図解します。

ここまで読んで「APIは便利そうだ」と感じてもらえたと思います。では、開発者の視点から見たとき、APIを使うことで具体的にどのくらいの効果があるのか。数字と一緒に見てみましょう。

APIについて学び始めると、多くの人が同じところでつまずきます。ここでは、初学者が陥りがちな3つの誤解を取り上げて、正しい理解に修正します。