REST API可以至少以两种方式拥有参数:
作为url路径的一部分(即/api/resource/parametervalue) 作为查询参数(例如/api/resource?=参数值)
这里的最佳实践是什么?什么时候使用1，什么时候使用2，有什么一般的指导方针吗?
真实世界的例子:Twitter使用查询参数来指定间隔。(http://api.twitter.com/1/statuses/home_timeline.json?since_id=12345&max_id=54321)
把这些参数放在URL路径中会被认为是更好的设计吗?
当前回答
作为一名经常在客户端工作的程序员，我更喜欢使用查询参数。另外，对我来说，它将URL路径从参数中分离出来，增加了清晰度，并提供了更多的可扩展性。它还允许我在URL/URI构建和参数构建器之间有单独的逻辑。
我很喜欢曼努埃尔·阿尔达纳说的另一种选择如果有某种树的话。我可以看到用户特定的部分被树形分开。
其他回答
作为一名经常在客户端工作的程序员，我更喜欢使用查询参数。另外，对我来说，它将URL路径从参数中分离出来，增加了清晰度，并提供了更多的可扩展性。它还允许我在URL/URI构建和参数构建器之间有单独的逻辑。
我很喜欢曼努埃尔·阿尔达纳说的另一种选择如果有某种树的话。我可以看到用户特定的部分被树形分开。
如果有记录在案的最佳实践，我还没有找到它们。然而，当我决定在url中放置参数时，这里有一些指导原则:
可选参数往往更容易放在查询字符串中。
如果您希望在参数值与现有资源不对应时返回404错误，那么我倾向于使用路径段参数。例如:/customer/232，其中232不是有效的客户id。
然而，如果你想返回一个空列表，那么当参数没有找到时，我建议使用查询字符串参数。例如/联系人吗?name =戴夫
如果一个参数影响URI空间的整个子树，则使用路径段。例如，语言参数/en/document/foo.txt和/document/foo.txt?语言= en
我希望唯一标识符位于路径段中，而不是查询参数中。
uri的官方规则可以在这个RFC规范中找到。这里还有另一个非常有用的RFC规范，它定义了参数化uri的规则。
根据URI标准，路径用于层次参数，查询用于非层次参数。离岸金融中心。对你来说什么是等级制度是非常主观的。
在将多个uri分配给相同资源的情况下，我喜欢将用于标识的参数放入路径中，将用于构建表示的参数放入查询中。(对我来说，这种方式更容易路由。)
例如:
/users/123和/users/123?字段= "姓名、年龄" /users和/users?name = " John "年龄= 30
对于map reduce，我喜欢使用以下方法:
/用户?name = " John "年龄= 30 /用户/名称:约翰/年龄:30岁
因此，如何构造uri实际上取决于您(以及您的服务器端路由器)。
注意:只是提到这些参数是查询参数。因此，您真正要做的是定义一种简单的查询语言。对于复杂查询(包含与、或、大于等操作符)，我建议您使用已经存在的查询语言。URI模板的功能非常有限…
根据universe-resource-locator提供的“上下文”“打包”和POST数据，这对于定位器来说意味着#1。
注意第二条的局限性。比起第一条，我更喜欢post。
注:此处讨论的局限性
POST参数内容是否有最大大小?
GET请求的长度有限制吗?和最大大小的URL参数在_GET
附注:这些限制是基于客户端功能(浏览器)和服务器(配置)。
以下是我的观点。
查询参数被用作请求的元数据。它们充当现有资源调用的过滤器或修饰符。
例子:
/ / 2014-08-08 /日历事件
应该给出当天的日历事件。
如果需要特定类别的事件
/日历/ 2014-08-08 /事件吗?类别=约会
或者你需要超过30分钟的比赛
/日历/ 2014-08-08 /事件吗?时间= 30
试金石测试是检查在没有查询参数的情况下是否仍然可以提供请求。
