REST服务资源命名

Question

我正在设计一个新的REST API端点并对API url有疑问。

例如，我有一个Product实体和相应的/products API。

，以获得特定的产品，一切都清楚了 - 我必须使用类似于：

GET /products/{productId} 

，以创建一个新的一切都太清晰：

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

但如何处理产品更新？

有两个选择，我可以看到现在：

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引用已存在的 资源，则封闭实体应该被认为是原始服务器上驻留的实体的修改版本 。

参考HTTP-Methods