rest - 这个 REST API 的参数值应该在哪里？为什么？

Question

我有以下 REST API：

POST /users/martin/notify/...

假设该 API 通知用户列表，用户 Martin 有话要说。要通知的用户列表可以从 1 到 1000 不等。一千个用户的列表应该在哪里：查询字符串、HTTP 标头或请求正文？为什么？

Answer 1

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