没有结果的REST搜索的HTTP状态代码

Question

我有一个用于搜索的RESTendpoint。

GET/人？名字=约翰

结果，返回一个具有HTTP状态代码＜code＞200 OK＜/code＞的集合：

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

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

>

HTTP 状态 200 正常，集合为空 []

HTTP状态204无内容，集合为空[]

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




Answer 1

这是设计web应用程序时的惯例。200 ok与一个空的集合将是我的路要走。因为:

• 事实证明，您的API确实返回了响应。
• 在客户端处理200会容易得多，因为我可能假设您正在使用Javascript，其他响应代码可能会向您抛出错误

Answer 2

国际海事组织第一个案例：

• HTTP 状态 200 正常，集合为空 []

然后您不必检查204并使用返回的内容，这是一个空列表。

Answer 3

我会推荐：

HTTP Status 200 OK with a empty collection []

原因是204意味着没有要发回的内容，这不是您的呼叫结果。

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

更新：

根据HTTP协议定义：

10.2.5 204无内容:服务器已经完成了请求，但是不需要返回实体主体，并且可能想要返回更新的元信息。

和：

204 响应不得包含消息正文，因此始终由标头字段后面的第一个空行终止。