RESTful POSTS，您是否将对象 POST 到单数或复数 Uri？

Question

以下哪一个 URI 更“适合”接收 POST(添加产品)？是否有任何可用的最佳实践或者只是个人偏好？

/product/(单数)

或

/产品/(复数)

目前，我们使用 /products/?query=blah 进行搜索，使用 /product/{productId}/ 进行单个产品的 GET、PUT 和 DELETE。

Answer 1

由于 POST 是“追加”操作，因此 POST 到 /products可能更加英国化，因为您会将新产品追加到现有列表中产品数量。

只要您对 API 中的某些内容进行了标准化，我认为就足够了。

由于 REST API 应该是超文本驱动的，因此 URI 相对来说是无关紧要的。客户端应该从返回的文档中提取 URI，并在后续请求中使用这些 URI；通常，应用程序和人们不需要猜测或直观地解释 URI，因为应用程序将明确指示客户端哪些资源和 URI 可用。