HTTP メソッドはどう CRUD に対応し、safe と idempotent は何を意味しますか?

例

PUT /users/42 は 表現全体 を送って置き換えます。PATCH /users/42 は 変更するフィールドだけ を送ります (例: { "email": "[email protected]" })。

Safe vs idempotent

これらは 2 つの異なる性質です:

• Safe — メソッドが server の状態を 変更しない (読み取り専用)。GET、HEAD、OPTIONS は safe です。
• Idempotent — 同じリクエストを N 回 行っても、1 回行うのと同じ効果を持つ。GET、PUT、DELETE、HEAD は idempotent です。

なぜ重要なのか

面接官がこれを尋ねるのは、信頼できる API を作れるほど HTTP のセマンティクスを理解しているか見るためです。safe/idempotent の区別は学術的ではありません: client、プロキシ、CDN が何を許されるかを直接支配します。Safe メソッドは自由にキャッシュ・プリフェッチできます。Idempotent メソッドはネットワークタイムアウト後に副作用を重複させるリスクなく 自動的に retry できます — だから client は PUT や DELETE を安全に retry できますが、POST の retry には注意が必要です (2 つの order を作るかもしれない)。典型的な間違いは GET で副作用を起こすこと (例: GET /users/42/delete) で、キャッシュを壊し、クローラが誤ってデータを変更しかねません。正しいメソッドを選び — その safety と idempotency の契約を尊重すること — が、API を予測可能で、ツールを組みやすく安全にします。