API — フロントとバックの会話の窓口

初級の解説は準備中のため、初級の内容を表示しています。

概要 — まず全体をつかむ

フロント(顔)とバックエンド(頭脳)は、どうやって会話するのか。その窓口の約束APIです。

詳細 — 1段階ずつ追う

これは何をする係?

レストランの注文票を思い浮かべてください。メニュー(決まった項目)に沿って書けば、決まった料理が返ってくる。お客さん(フロント)と厨房(バック)は、注文票という共通の形を通してやり取りします。

APIも同じ。「この形でお願いすれば、この形で返す」という約束です。

登場人物メモ:

  • ※1 エンドポイント — お願いの宛先(「この用件はここへ」)
  • ※2 JSON — やり取りに使う、決まった形のデータ表現

仕事の流れ

  1. フロントが「この形でください」とAPIにお願いする(※3 メソッド+宛先)
  2. バックエンドが受け取り、認証・認可を確認して処理する
  3. 結果を決まった形(JSON)にまとめて返す
  4. フロントはその形を前提に、画面へはめ込む

登場人物メモ:

  • ※3 メソッド — お願いの種類(取得=GET、送信=POST など)

なぜ「決まった形」にする?

  • 壊れにくい — 窓口の形さえ守れば、フロントもバックも別々に作り替えられる
  • 使い回せる — Webのフロントでも、スマホアプリでも、同じAPIを呼べる
  • 分業できる — 「窓口はこの形」と決めれば、フロント担当とバック担当が並行して作れる

⚠️ うまくいかないとき

  • 形が違う(400) — お願いの形が約束と違う
  • 本人確認できない(401)/権限なし(403) — 認証・認可で止められた
  • 宛先が無い(404) — そのエンドポイントが存在しない

理解度チェック

そのまま解けます(成績は保存されません)。無料アカウントを作ると、学習の記録と進捗の山登りが始まります。

1. APIが「決まった形」であることの利点に最も近いのは?

2. APIを一言でいうと?

3. APIのやり取りに使う「決まった形のデータ表現」に当たるのはどれ?

4. 「本人確認ができない」ときに返るコードに近いのはどれ?

5. 本文が挙げる「決まった形にする利点」に当たるのはどれ?

6. 「そのエンドポイントが存在しない」ときに返るコードはどれ?

7. 「取得」のお願いに使うHTTPメソッドを英字で答えてください。

8. APIのお願いの宛先(「この用件はここへ」)を指す片仮名の用語を答えてください。

API — フロントとバックの会話の窓口 | Kotowary