我正在尝试设计一个 RESTful API，用户可以在其中通过单个 GET 请求获取单个产品或产品列表。每个产品都有一个唯一的 ID。
单品网址很简单：
http://mycompany.com/api/v1/product/id
这将返回单个产品的信息。我对多个产品信息的 URL 应该是什么样子感到困惑。
怎么样
http://mycompany.com/api/v1/product/ids
其中 ids 是逗号分隔的 id 列表？
【问题讨论】：
标签： rest
我建议您将其视为列出按 id 过滤的资源的多种表示形式。因此，您向基础资源发出 GET 请求：
https://example.com/api/v1/products
并通过id过滤响应列表：
https://example.com/api/v1/products?id=1,2,3
【讨论】：
/products 和 products?id=1,2,3 将给出一致响应（=收集资源）。比较 /products/1 和 /products/1,2,3 是让客户头疼的秘诀 - 当然，除非所有嵌套端点默认返回集合（这也是一种有趣的方法，例如，请参见 api+json 格式）
id 等于 [1, 2, 3]，但 Ruby on Rails 会告诉您它等于 3，并且其他框架的行为也可能不同，例如说id 等于1。
products?id= 不会返回任何结果，而products 会返回所有结果。
id 是要匹配的对象上的字段。
您对用逗号分隔的 id 的建议已经足够了。
检查一些公共 REST API 以了解它们的处理方式会很有启发性。例如，StackExchange API 用分号分隔 id - https://api.stackexchange.com/docs/answers-by-ids
【讨论】：
/api/dogs/fluffy1234 可以扩展为执行更多类似的操作：/api/dogs/fluffy1234/siblings 等，如果您可以将选择器逻辑保留在 ID 通常所在的位置，那么您仍然可以使用您的装饰器