这个REST API的参数值应该放在哪里?为什么?

时间:2012-01-12 03:20:01

标签: rest restful-architecture

我有以下REST API:

POST /users/martin/notify/...

API假设用户列表通知用户Martin有话要说。要通知的用户列表可以从1到1000不等。一千个用户的列表应该是:Querystring,HTTP Header还是Request body?为什么呢?

1 个答案:

答案 0 :(得分:1)

请求正文。标题和查询字符串在实践中通常具有大小限制,您肯定会遇到一千个标识符。在更理论的层面上,请求体应该是您希望服务器通过POST处理的实体。标题是关于该实体的协议级元数据;也就是说,有助于实体处理的信息,而不是实体本身。查询字符串是资源的标识符的一部分,也不是该资源的表示。