【初心者向け】APIとは？レストランの注文に例えて5分で理解する

この記事で解決すること

「APIって何？プログラミングの記事を読んでいるとよく出てくるけど、意味が分からない」

この記事を読めば、APIが何なのか、なぜ必要なのかが5分で分かります。

APIは「ウェイター」です。

あなた（お客さん）は、キッチン（サーバー）に直接入って料理を作ることはできません。代わりに、ウェイター（API）に「カレーください」と注文します。ウェイターがキッチンに伝えて、料理ができたらあなたのテーブルに届けてくれます。

天気予報アプリは、自分で天気を観測しているわけではありません。気象庁やOpenWeatherMapなどの「天気API」に「東京の天気を教えて」とリクエストを送り、返ってきたデータを画面に表示しています。

Webサイトに地図を表示するとき、自分で地図を作る必要はありません。Google Maps APIを使えば、「この住所の地図を表示して」とリクエストするだけで地図が表示されます。

「Googleでログイン」「LINEでログイン」というボタンは、GoogleやLINEのAPIを使っています。自分でパスワード管理の仕組みを作らなくても、既存のサービスの認証機能を借りられます。

APIは基本的に「リクエスト」と「レスポンス」のやり取りです。

あなたのアプリ → リクエスト（「東京の天気を教えて」） → 天気API
天気API → レスポンス（「晴れ、25度」） → あなたのアプリ

リクエストとレスポンスのデータ形式には、JSONがよく使われます。

JSONについては別の記事で解説しています。 👉 JSONとは？5分で分かるデータ形式の基本

多くのAPIは「APIキー」という鍵が必要です。これは「あなたが誰か」を識別するためのもので、無断で大量にアクセスされるのを防ぐ仕組みです。

APIキーはパスワードと同じくらい大切です。コードに直接書かず、環境変数で管理してください。