json - 无结果的 REST 搜索的 HTTP 状态代码

Question

我有一个用于搜索的 REST 端点。

GET/person?firstname=john&name=smith

作为结果，返回一个带有 HTTP 状态代码 200 OK 的集合:

[
   {
      "id":11,
      "firstname":"John",
      "name":"Smith",
      "birthday":"1996-03-08"
   },
   {
      "id":18,
      "firstname":"John",
      "name":"Smith",
      "birthday":"1963-07-11"
   }
]

空搜索结果的正确 HTTP 状态代码和负载是什么？

• HTTP 状态 200 OK 带有一个空集合 []

• HTTP 状态 204 No Content 带有空集合 []

• HTTP 状态 204 无内容，正文为空

Answer 1

我会推荐:

HTTP Status 200 OK with a empty collection []

原因是 204 表示没有内容要发回，这不是您调用的结果。

在你的情况下，有些东西要发回。这是一个 Json 结果，恰好由一个空集合组成。

更新:

来自HTTP协议(protocol)定义:

10.2.5 204 No Content: The server has fulfilled the request but does not need to return an entity-body, and might want to return updated metainformation.

和:

The 204 response MUST NOT include a message-body, and thus is always terminated by the first empty line after the header fields.