「API」という言葉を聞いた瞬間、脳がシャットダウンして「あ、自分、文系なんで」と逃げ出したくなる気持ちは分かります。
しかし安心してください。
APIの正体は、最先端の科学技術でも魔法でもありません。
一言で言えば、システム界における「最強のパシリ」です。
APIは有能な店員さんである
例えばあなたがファミレスに行ったとします。
あなたは「ハンバーグが食べたい」と思っていますが、厨房に入って自分で肉をこねることはできません。
というか、不審者として通報されます。
そこで登場するのが「店員さん」です。
- あなたが店員さんに「ハンバーグください」と頼む。
- 店員さんが厨房(システム)に伝えに行く。
- 厨房が作った料理を、店員さんがあなたのテーブルに運んでくる。
この「店員さん」の役割こそがAPIです。
あなたが使っているアプリが、別の巨大なシステム(GoogleやLINEなど)に「ちょっとデータちょうだい!」とおねがいする時、その仲立ちをしてくれる窓口のことです。
API = システム同士を繋ぐ店員さん
「API連携」は何が嬉しいのか
世の中には「API連携」という言葉が溢れています。
これは、店員さんが他の店からも出前を取ってきてくれるような状態です。
例えば、あなたの自作アプリに「明日の天気」を表示させたいとします。
自分で気象衛星を打ち上げるのは無理ですが、気象庁や天気予報サービスのAPIを使えば、数行の命令を書くだけで最新のデータが手に入ります。
これを「開発効率が上がる」と言ったりしますが、要するに「他人のふんどしで相撲を取れる」ということです。
APIがやってくれる処理については自分で作らなくていいので圧倒的に楽ができます。
APIキーは秘密の入館証
APIを誰にでも開放していると、悪い人がシステムをパンクさせるかもしれません。
そこで、APIを使うには「APIキー」が必要になります。
これは、マンションのオートロックを開けるカードキーや、「名前入りの入館証」だと思ってください。
「私は怪しい者ではありません。このキーを持っているので、データを見せてください」という証明書です。
もしこのキーが他人にバレると、あなたの名義で勝手にデータを死ぬほど使われ、挙句の果てに高額な請求が来ることもあります。
APIキーは、ネット上の住所よりも厳重に管理すべき「超・重要情報」です。
エンドポイントとリクエストの仕組み
APIを使いこなすには、「エンドポイント」という言葉を避けて通れません。
これは、役所の「3番窓口(住民票)」や「5番窓口(税金)」のような、「具体的な受付場所のURL」のことです。
「天気が知りたいなら、このURLにアクセスしてね」
「翻訳してほしいなら、こっちのURLだよ」
このように、目的ごとに送り先が決まっています。
そこに、「リクエスト(お願い)」を投げると、システムが「レスポンス(お返事)」を返してくれます。
なぜエラーが出るのか
たまに「APIエラー」という不吉な表示が出ることがあります。
これは、パシリであるAPIが仕事を拒否した状態です。
- 404エラー:「そんな窓口(URL)は存在しないよ」と言われています。
- 401エラー:「入館証(APIキー)が間違ってるよ」と追い返されています。
- 500エラー:厨房(サーバー)の中でコックさんがパニックを起こしています。
これらが出たときは、慌てずに「店員さんになんて言われたか」を確認するのが解決の近道です。
APIは世界を繋ぐ接着剤
APIがあるおかげで、今のネット社会は成り立っています。
インスタの写真を投稿したり、スマホで地図を見たり、ChatGPTと会話したりできるのは、すべて裏でAPIという店員さんが必死に走り回っているからです。
ITの世界は一見複雑ですが、中身はとても人間味あふれる「お願いと返事」の繰り返しでできています。


コメント