bool 资源的 HTTP 状态代码

Question

我在工作中开发 API 时遇到了一个难题。假设我有一个资源路由，如下所示:

/order/:orderId/returnable

此资源应该检查订单是否可以退回商店。现在，如果 IS 可返回，它会回复 200 状态码，否则会回复 404 状态码。

一位同事正确地指出资源并没有消失，我应该使用 200 进行任何响应，然后使用包含我的结果的正文进行响应。

两者都有其语义，我看不出一个明显的赢家。

我们应该使用什么响应状态码？而且体内应该有什么东西？

Answer 1

您的同事是对的。根据规范(http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5)，它说 404 是“服务器没有找到与请求 URI 匹配的任何内容”。在您的情况下，服务器找到了需要返回的东西。您需要定义响应此 API 时返回的实体的语法，并返回 HTTP 200。它可以像 bool 值一样简单，也可以是任何有意义的东西，只要它有记录。

如果给定的“orderId”不存在，它应该返回 HTTP 404。