RESTサービスリソースの名前付け

Question

私は新しいREST APIエンドポイントを設計しており、APIのURLについて疑問を抱いています。

たとえば、私はProductエンティティと対応する/products APIを持っています。

特定の製品を得るために、すべてが明確である - 私はのようなものを使用する必要があります：新しいものすべてを作成するために

GET /products/{productId} 

をあまりにも明白である：

POST /products with a product details in the HTTP request body 

どのように製品のアップデートに対処するのですか？

私は今見ることができる2つのオプションがあります：

PUT /products/{productId} with a new product details in the HTTP request body 

または

PUT /products with a {productId} and new product details in the HTTP request body 

は、製品の同じ質問を削除します。

{productId}をサーバーに送信するためのベストプラクティスは何ですか。

Answer 1

製品を更新するには、PUT/products/{id}を使用してください。 本文には、リソースまたは変更を送信する必要があります。

PUTメソッドは、囲まれたエンティティが 指定されたRequest-URIの下に格納されることを要求します。 Request-URIがすでに存在する リソースを参照する場合、囲まれたエンティティは、オリジンサーバ上に存在するものの変更された バージョンとみなされるべきです（SHOULD）。

リファレンスHTTP-Methods