フロント(顔)とバックエンド(頭脳)は、どうやって会話するのか。その窓口の約束がAPIです。
初級の解説は準備中のため、初級の内容を表示しています。
概要 — まず全体をつかむ
詳細 — 1段階ずつ追う
これは何をする係?
レストランの注文票を思い浮かべてください。メニュー(決まった項目)に沿って書けば、決まった料理が返ってくる。お客さん(フロント)と厨房(バック)は、注文票という共通の形を通してやり取りします。
APIも同じ。「この形でお願いすれば、この形で返す」という約束です。
登場人物メモ:
- ※1 エンドポイント — お願いの宛先(「この用件はここへ」)
- ※2 JSON — やり取りに使う、決まった形のデータ表現
仕事の流れ
- フロントが「この形でください」とAPIにお願いする(※3 メソッド+宛先)
- バックエンドが受け取り、認証・認可を確認して処理する
- 結果を決まった形(JSON)にまとめて返す
- フロントはその形を前提に、画面へはめ込む
登場人物メモ:
- ※3 メソッド — お願いの種類(取得=GET、送信=POST など)
なぜ「決まった形」にする?
- 壊れにくい — 窓口の形さえ守れば、フロントもバックも別々に作り替えられる
- 使い回せる — Webのフロントでも、スマホアプリでも、同じAPIを呼べる
- 分業できる — 「窓口はこの形」と決めれば、フロント担当とバック担当が並行して作れる
⚠️ うまくいかないとき
- 形が違う(400) — お願いの形が約束と違う
- 本人確認できない(401)/権限なし(403) — 認証・認可で止められた
- 宛先が無い(404) — そのエンドポイントが存在しない
理解度チェック
そのまま解けます(成績は保存されません)。無料アカウントを作ると、学習の記録と進捗の山登りが始まります。
問1. APIが「決まった形」であることの利点に最も近いのは?
問2. APIを一言でいうと?
問3. APIのやり取りに使う「決まった形のデータ表現」に当たるのはどれ?
問4. 「本人確認ができない」ときに返るコードに近いのはどれ?
問5. 本文が挙げる「決まった形にする利点」に当たるのはどれ?
問6. 「そのエンドポイントが存在しない」ときに返るコードはどれ?
問7. 「取得」のお願いに使うHTTPメソッドを英字で答えてください。
問8. APIのお願いの宛先(「この用件はここへ」)を指す片仮名の用語を答えてください。