コレクションとアイテムでは、成り立つ操作が違う
/usersのようなコレクションのURLは、全件を一覧するGETと、新しい1件を作成するPOSTを受け付けます。作成する時点では、新しいユーザーはまだ存在せず、idもありません。そのためPOSTは/usersに送り、idはサーバーが作成時に決めて、レスポンスで返します。
/users/42のようなアイテムのURLは、その1件を読み取るGETと、更新するPUTまたはPATCH、削除するDELETEを受け付けます。アイテムのURLに対するPOSTや、コレクションのURLに対するPUT・DELETEは、この対応に含まれません。/usersにはどの1件かを示すidがなく、PUTでどの1件を置き換えるのか、DELETEでどの1件を削除するのかが決まらないからです。
この課の目標
作成・取得・更新・削除の各操作を、正しいHTTPメソッドと、コレクションのURLかアイテムのURLかという対象に対応づけられる。
id 9のユーザーを削除したい。どのリクエストが合う?