相关疑难解决方法(0)

REST API最佳实践:在何处放置参数?

REST API至少可以通过两种方式获取参数:

  1. 作为URL路径的一部分(即/api/resource/parametervalue )
  2. 作为查询参数(即/api/resource?parameter=value )

这里的最佳做法是什么?是否有任何一般指导原则何时使用1以及何时使用2?

真实世界的例子:Twitter使用查询参数来指定间隔.(http://api.twitter.com/1/statuses/home_timeline.json?since_id=12345&max_id=54321)

将这些参数放在URL路径中会被认为是更好的设计吗?

api rest url

348
推荐指数
7
解决办法
72万
查看次数

我何时在RESTful API中使用路径参数与查询参数?

我想让我的RESTful API非常可预测.决定何时使用URI而不是使用查询参数来分段数据的最佳做法是什么.

对我来说,支持分页,排序和分组的系统参数在'?'之后是有道理的.但是如果像'status'和'region'这样的字段或其他属性来分割你的收藏呢?如果那些也是查询参数,那么知道何时使用路径参数的经验法则是什么?

rest api-design spring-mvc restful-url restful-architecture

98
推荐指数
6
解决办法
6万
查看次数

REST API最佳实践:查询字符串与请求正文中的args

REST API可以在几个地方包含参数:

  1. 在请求正文中 - 作为json正文或其他MIME类型的一部分
  2. 查询字符串中 - 例如/api/resource?p1=v1&p2=v2
  3. 作为URL路径的一部分 - 例如/api/resource/v1/v2

选择上述1和2之间的最佳做法和考虑因素是什么?这里
涉及2对3 .

api rest json http query-string

83
推荐指数
4
解决办法
6万
查看次数