APIとは？意味と使われ方を身近なたとえでやさしく理解する

APIとは、アプリやサービスどうしが、決められた方法で情報をやり取りするための「窓口」です。人が直接データベースを触るのではなく、必要な情報だけを安全に受け渡しするために使います。Web開発ではとてもよく出てくる言葉ですが、まずは「別のソフトにお願いを出して、結果を受け取る仕組み」と考えると理解しやすくなります。

導入

APIという言葉は難しそうに見えますが、考え方はシンプルです。たとえば、天気を表示するアプリがあるとします。そのアプリは、空を見に行って自分で天気を判断しているわけではありません。天気情報を持っている別のサービスに問い合わせて、結果を受け取って画面に出しています。この「問い合わせて、返してもらう」やり取りの入り口がAPIです。

新社会人の方だと、「APIは開発者だけが使うもの？」と思うかもしれません。実際には、普段使っている予約サイト、地図アプリ、決済サービス、SNSログインなど、見えないところでAPIが動いています。つまりAPIは、Webサービスをつなぐための裏方です。

APIの基礎

APIは Application Programming Interface の略ですが、英語の全部を覚える必要はありません。大切なのは、何をお願いできるか と どう返ってくるか が決まっていることです。人間でいうと、受付窓口や注文口に近い役割です。ルールがあるから、相手が違っても同じ形でやり取りしやすくなります。

Web開発でよくあるのは、アプリがAPIに対して「この会員の情報をください」「この商品の一覧をください」と依頼し、APIが必要なデータを返す形です。返ってくるデータは、JSONという形で送られることが多いです。JSONは、コンピューターが読みやすいように整理された文字列の形式で、アプリ同士の会話に向いています。

APIは画面そのものではありません。画面は人が見る部分、APIは裏で動く受け渡しの部分です。この違いを分けて考えると、WebサイトとWebサービスの仕組みが見えやすくなります。

近いようで少し違います。APIは「押せるボタン」ではなく、「ソフト同士が決められた手順で話すための入口」です。ボタンは人向け、APIは主にシステム向けと考えると分かりやすいですよ。

身近なたとえで見るAPI

APIをレストランにたとえると、わかりやすくなります。お客さんは料理を作る必要がありません。メニューを見て注文し、店員さんに伝えます。店員さんは厨房に内容を伝え、できあがった料理を席まで運びます。このとき、店員さんの役割がAPIに近いです。お客さんは厨房の中を直接触らず、決まった手順で注文だけします。

もしAPIがなかったら、アプリは相手のサービスの中身を直接理解しなければなりません。住所の保存方法、データの並び順、更新の手順まで、全部ばらばらだと困ります。APIがあると、注文の出し方がそろうので、作る側も使う側も仕事がしやすくなります。

もう一つのたとえは、銀行の窓口です。ATMやアプリから振り込みをすると、内部の仕組みは見えませんが、決められた手順で処理されています。利用者は細かい内部構造を知らなくても、必要な操作だけで目的を達成できます。APIも同じで、難しい中身を全部知らなくても、決まった入口から必要な機能を使えるのが強みです。

実務での使われ方

実際の現場では、APIはかなり広く使われます。たとえば、ECサイトでクレジットカード決済を使うとき、サイトは決済会社のAPIを呼び出して支払いを進めます。自社でカード処理の仕組みを一から作らなくても、外部サービスを安全に使えるわけです。

地図アプリでもAPIは活躍します。お店の住所を入力すると、地図サービスのAPIから位置情報を受け取り、地図やルート案内を表示します。天気情報、郵便番号、翻訳、SMS送信、会員登録、SNSログインなども、API連携の代表例です。ユーザーから見ると一つのアプリに見えても、裏では複数のサービスがつながっています。

仕事では、社内システム同士をつなぐときにもAPIを使います。たとえば、営業管理システムの受注情報を、会計システムへ自動で送るといった使い方です。手作業でコピーする回数が減るので、入力ミスや時間のロスを抑えやすくなります。

ただし、APIを使えば何でも自由にできるわけではありません。利用回数に上限があったり、認証のためのAPIキーが必要だったり、送れるデータの形式が決まっていたりします。これは、誰でも好き勝手に使えないようにするための大事なルールです。実務では、仕様書を読み、必要なパラメータをそろえて、正しい順番で呼び出すことが重要になります。

図解で整理

APIの流れは、次の順番で考えると整理しやすいです。まずアプリが画面上の操作を受け取ります。次に、必要な情報をAPIへ送ります。APIは裏側のサービスやデータベースにつなぎ、結果を受け取ります。そして、受け取った内容をアプリが見やすい形にして画面へ表示します。

この流れのポイントは、画面を作る役 と データを受け渡しする役 が分かれていることです。役割が分かれていると、画面の見た目を変えても、APIの仕組みを大きく変えずに済むことがあります。逆に、APIの仕様が変わると、受け取る側のアプリも合わせて修正が必要です。

たとえば、スマホアプリとWebサイトが同じ会員情報APIを使っていれば、両方で似た情報を表示できます。ひとつの窓口を共有するイメージです。ここがAPIの便利なところで、違う画面でも同じデータを使い回しやすくなります。

3問クイズ

Q1. APIとは、ひとことで言うと何のための仕組みでしょうか。

Q2. APIは、画面に見えるボタンそのものと同じでしょうか。

Q3. WebサービスでAPIがよく使われる場面を一つ挙げるとしたら、どんな例がありますか。

まとめ

APIとは、ソフトやサービスが決められた手順で会話するための窓口です。画面では見えにくいですが、実は多くのWebサービスの土台になっています。まずは「頼む側」と「返す側をつなぐ仕組み」と覚えれば十分です。