Webシステムを外部から利用するためのプログラムの呼び出し規約(API)の種類の一つで、REST原則に従って策定されたもの
引用：https://e-words.jp/w/REST_API.html

REST APIとは、前章で学んだREST原則に従って設計されたWeb APIのこと。HTTP技術をベースとしており、HTTPメソッド（GET、POST、PUT、PATCH、DELETE）を使ってクライアントとサーバー間でデータをやり取りする。

HTTP（HyperText Transfer Protocol）は、WebサーバとクライアントのWebブラウザがデータを送受信するために使用するプロトコル。HTTPメソッドは、リクエストを行う際に「どのような操作を行いたいか」を表現する。

PUTとPATCHの違い

同じ「更新」でも、送るデータの範囲が異なる。

PUT /products/123
→ リソース全体を送る（送らなかったフィールドはnullや初期値になる）
{ "name": "Tシャツ", "price": 2000, "description": "コットン100%" }

PATCH /products/123
→ 変更したいフィールドだけ送る（送らなかったフィールドはそのまま）
{ "price": 1500 }

HTTPステータスコードとは、サーバーがクライアントに返す3桁の数字。リクエストの結果（成功、エラー等）を表す。

運用上のポイント

• 適切なステータスコードを返す
  • 全て200で返すと、クライアント側でエラーハンドリングができない
• 400番台と500番台の意味を理解する
  • 400番台はクライアントの問題（URLの打ち間違い、必須パラメータの不足等）
  • 500番台はサーバーの問題（バグ、DB接続障害等）
• 500番台の監視体制を作る
  • 本番運用では500番台のエラーが出たらアラートを飛ばし、すぐに調査する

REST APIでは、リクエストに追加情報を渡す方法が複数ある。

URLの ? の後に key=value 形式で付与する。検索条件やフィルタリングに使う。

https://example.com/products?category=electronics&price=1000

• category=electronics と price=1000 がクエリパラメータ
• 複数ある場合は & で繋ぐ
• 用途: 一覧取得時の絞り込み、ページネーション（?page=2&limit=20）など

URLのパス部分に埋め込む。特定のリソースを一意に指定するのに使う。

https://example.com/products/12345

• 12345 がパスパラメータ（商品ID）
• 用途: 特定のリソース1件を取得・更新・削除するとき

APIは一度公開すると、利用者（クライアント）がそのインターフェースに依存する。大きく仕様を変えると既存のクライアントが動かなくなるため、バージョンを分けて管理する。

• レスポンスの形式を変えたい（フィールド名の変更、構造の変更）
• エンドポイントの設計を見直したい
• 破壊的変更を入れたいが、既存の利用者を壊したくない

実務ではパスに含める方式が最も多い。