rest - API 开发 : When to return a BAD REQUEST HTTP Status Code (REST)

Question

我们正在创作 REST 服务，当有人请求具有不存在的父 ID 的资源时该怎么做存在争议。

示例:您要获取与公司关联的人员列表，因此您 GET 的 ID 为 1，但该公司 ID 不存在。

我认为 REST 的定义表明我们将简单地返回一个空列表(导致 HTTP 204 (No Content))，因为 HTTP 错误请求仅适用于格式错误的语法，根据规范:

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

由于语法错误，服务器无法理解请求。客户端不应该在没有修改的情况下重复请求。

我认为没有错误要解释也更清楚，您请求的资源不存在。

对最佳实践的想法？

这里有一个 SO 讨论:HTTP 400 (bad request) for logical error, not malformed request syntax虽然它有点抽象，但如果我应该发布这个，或者只是使用那个问题，我会很伤心。

Answer 1

如果你这样做了

GET /company/1

并且不存在 id 为 1 的公司，那么我认为适当的 HTTP 状态代码是 404 - 未找到。

但是，如果你要这样做，

GET /companies?id=1

然后我会返回一个 200 和一个空的公司列表。