对命名约定复数与单数的更多帮助答案

【问题标题】：some more help for naming conventions plural vs singular对命名约定复数与单数的更多帮助
【发布时间】：2015-05-31 22:12:29
【问题描述】：

那里有答案，但我的问题有所不同，因为当我有产品详细信息或当我必须返回产品及其客户的详细信息时，我试图找出 uri。我需要一个标准解决方案来处理 4 个 api 调用。我需要针对这种特殊情况的标准命名约定，请从以下修复它们。

复数（带 s）

GET /products - 列出所有产品

GET /products/1 - 仅产品详细信息（无客户）

单数

GET /product/1 - 产品及其客户的详细信息

GET /product/1/customers 仅限产品 1 的客户

从上面我试图找到这两个的解决方案。

GET /products/1 - 仅产品详细信息（无客户）

GET /product/1 - 产品及其客户的详细信息

【问题讨论】：

【解决方案1】：

不，不要使用不同的 URL 来区分有客户和没有客户的产品。使用content negotioation。

要获得嵌入式客户的产品，请使用Accept 标头：

GET /products/1
Accept: application/vnd.com.example.rest.customer.long+json

要获得没有客户的产品，请使用不同的Accept 标头。

GET /products/1
Accept: application/vnd.com.example.rest.customer.short+json

但请始终使用相同的网址，因为您请求的是相同的资源。要请求此 URL 的不同表示，请使用内容协商。

【讨论】：

太好了，谢谢，我注意到你用了复数形式，GET /products/1，我把它们弄混了，单数不是用来查询单个项目的吗？在这种情况下GET /product/1
我将资源命名为/products（复数），因为这是所有产品的集合资源。
好的，DELETE /products/1、PUT /products/1、POST /products/1（复数）你会用什么？
是的。 /products/1 标识 ID 为 1 的产品。但 REST 不在乎。重要的是要保持一致。
我只返回对象，而不是数组。