[包子分享]REST API Best practices: Where to put parameters?

在上一篇博客中，包子为您解说了REST设计风格的理论概念，相信有很多同学读完以后会有很多实际的问题需要进一步探讨。在这里，包子为大家转载了一个比较热门的最佳设计实践问题：如何设计REST风格的URI？从上篇文章里，我们知道URI是HTTP实现下的REST资源ID。URI一般包含了指向资源的路径，以及参数来指定请求获取的特定资源状态。那么到底什么应该是属于URI路径的一部分，而什么又该放入URI呢？这是一个值得大家思考的设计实践。

原文链接：http://stackoverflow.com/questions/4024271/rest-api-best-practices-where-to-put-parameters

Question

from: Kalle Gustafsson

A REST API can have parameters in at least two ways: As part of the URL-path (i.e. /api/resource/parametervalue ) As a query argument (i.e. /api/resource?parameter=value )

What is the best practice here? Are there any general guidelines when to use 1 and when to use 2?

Real world example: Twitter uses query parameters for specifying intervals. (http://api.twitter.com/1/statuses/home_timeline.json?since_id=12345&max_id=54321)

Would it be considered better design to put these parameters in the URL path?

（请点击底部左下角的原文链接阅读全文。）