api - 具有复合 ID 的 REST 资源的 URL

Question

我正在创建一个 REST API，其中我的一些资源具有由两个独立部分组成的复合 ID。一个示例是给定纬度和经度的资源。

我最初的想法是将 ID 的每个复合部分添加为路径的单独部分，如下所示:

http://localhost/phone-details/Vodafone/07123000000 - Operator and number

http://localhost/location-details/50/-2 - Lat and long

这是采用这种方法的最佳实践吗？也许应该使用查询字符串，以便每个复合 ID 部分都有一个清晰易懂的名称？或者，复合 ID 是否应该仅通过逗号分隔来传递？

Answer 1

我可以给你推荐一本好书Restful web services cookbook从那里开始(第 77 页)

Use the comma ( , ) and semi-colon ( ; ) characters to indicate nonhierarchical portionsof the URI.

The semicolon convention is used to identify matrix parameters:

http://www.example.org/co-ordinates;w=39.001409,z=-84.578201http://www.example.org/axis;x=0,y=9