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路径中会被认为是更好的设计吗?
当前回答
根据URI标准，路径用于层次参数，查询用于非层次参数。离岸金融中心。对你来说什么是等级制度是非常主观的。
在将多个uri分配给相同资源的情况下，我喜欢将用于标识的参数放入路径中，将用于构建表示的参数放入查询中。(对我来说，这种方式更容易路由。)
例如:
/users/123和/users/123?字段= "姓名、年龄" /users和/users?name = " John "年龄= 30
对于map reduce，我喜欢使用以下方法:
/用户?name = " John "年龄= 30 /用户/名称:约翰/年龄:30岁
因此，如何构造uri实际上取决于您(以及您的服务器端路由器)。
注意:只是提到这些参数是查询参数。因此，您真正要做的是定义一种简单的查询语言。对于复杂查询(包含与、或、大于等操作符)，我建议您使用已经存在的查询语言。URI模板的功能非常有限…
其他回答
我通常倾向于#2，作为查询参数(即/api/resource?=参数值)。
第三种选择是将parameter=value放到函数体中。
这是因为它可以更好地用于多参数资源，并且具有更强的可扩展性以供将来使用。
不管你选哪一个，确保你只选一个，不要混搭。这导致了一个令人困惑的API。
我看到很多REST api不能很好地处理参数。经常出现的一个例子是URI包含个人身份信息。
http://software.danielwatrous.com/design-principles-for-rest-apis/
我认为一个必然的问题是，当一个参数根本不应该是一个参数，而应该被移动到请求的HEADER或BODY。
这是个很有趣的问题。
你可以同时使用它们，关于这个主题没有任何严格的规则，但是使用URI路径变量有一些优点:
缓存: 大多数互联网上的web缓存服务不缓存GET请求时，他们包含查询参数。 他们这样做是因为有很多RPC系统使用GET请求来更改服务器中的数据(失败!!)Get必须是一个安全的方法)
但是如果使用路径变量，所有这些服务都可以缓存GET请求。
层次结构: 路径变量可以表示层次结构: /城市/街道/的地方
它为用户提供了关于数据结构的更多信息。
但如果你的数据没有任何层次关系，你仍然可以使用Path变量，使用逗号或分号:
/城市/经度,纬度
作为规则，当参数的顺序重要时使用逗号，当顺序不重要时使用分号:
/ IconGenerator /红色,蓝色,绿色
除了这些原因之外，在某些情况下，使用查询字符串变量是非常常见的:
当您需要浏览器自动将HTML表单变量放入URI时 当你处理算法的时候。例如谷歌引擎使用查询字符串:
http:// www.google.com/search ? q =休息
总而言之，没有任何强烈的理由使用这种方法，但只要可以，就使用URI变量。
根据universe-resource-locator提供的“上下文”“打包”和POST数据，这对于定位器来说意味着#1。
注意第二条的局限性。比起第一条，我更喜欢post。
注:此处讨论的局限性
POST参数内容是否有最大大小?
GET请求的长度有限制吗?和最大大小的URL参数在_GET
附注:这些限制是基于客户端功能(浏览器)和服务器(配置)。
这取决于设计。HTTP上的REST没有uri规则(主要是它们是唯一的)。通常这涉及到品味和直觉的问题……
我采取以下方法:
url path-element:资源和它的path-element组成了一个目录遍历和一个子资源(例如/items/{id}， /users/items)。不确定的时候问问你的同事，如果他们认为遍历和他们认为在“另一个目录”最有可能的路径元素是正确的选择 Url参数:当没有遍历时(有多个查询参数的搜索资源就是一个很好的例子)
