APIは、サービスの機能やデータを、ほかのアプリから利用するための決められた窓口。
アプリは窓口へお願いを送り、サービスは結果を返します。
APIはサービスの「決められた窓口」
APIは「Application Programming Interface」の略です。アプリやサービス同士が、決められた方法で機能やデータをやり取りするための接点を指します。
お店で商品を受け取るとき、利用者が倉庫へ直接入るのではなく、窓口で注文します。APIも同じように、サービス内部を直接触らせず、利用できる機能だけを窓口として公開します。
必要な機能やデータをAPIへお願いする。
お願いを受け取り、決められた形でサービスへつなぐ。
処理を行い、結果やデータをAPI経由で返す。
同じ機能を、いろいろなアプリから使える
APIがあると、Webアプリ、スマホアプリ、AIツールなど、異なるアプリから同じサービスの機能を利用できます。
住所から地図を表示したり、地域の天気データを取得したりする。
支払いを依頼したり、荷物の配送状況を確認したりする。
文章や画像の生成を依頼し、作られた結果をアプリで使う。
外部サービスの複雑な仕組みを自分で作らなくても、公開されたAPIを利用すれば、その機能を自分のアプリへ組み込めます。
API通信も「お願い」と「返事」の往復
APIを利用するアプリは、必要な情報をリクエストとして送ります。APIは内容を受け取り、サービス側で処理した結果をレスポンスとして返します。
Webで使われるAPIの多くはHTTPで通信し、結果をJSONというデータ形式で返します。つまり、API通信はHTTPのリクエストとレスポンスを、アプリ同士のやり取りに使ったものと考えられます。
使い方はAPIごとに決められている
窓口で注文方法が決まっているように、APIにも送り先、送れるお願い、必要な情報、返ってくる結果の形などのルールがあります。利用する側は、APIの説明書に従ってリクエストを作ります。
どの機能へお願いを送るのかを示す。
何をしてほしいか、必要な条件と一緒に送る。
成功・失敗の状態や、処理結果のデータを受け取る。
誰でも自由に使えるAPIもあれば、APIキーなどで利用者を確認するAPIもあります。回数制限や料金、利用できるデータの範囲もサービスごとに異なります。
ここまでのまとめ
APIは、あるサービスの機能やデータを、別のアプリから利用するための窓口です。利用するアプリは決められた方法でリクエストを送り、APIからレスポンスを受け取ります。
APIは、サービスの中身を直接触らずに、公開された機能を決められた方法で利用するための窓口です。
このUIを実装してみよう