rest - REST API 中的空子资源应使用哪个 HTTP 代码？

Question

假设我在 /articles 处有一个资源 articles。

这些文章可能有相关文章，因此我通过 GETting /articles/{id}/lated 来获取它们。

没有相关文章我应该返回什么？

我能想到:

• 404 Not Found，可能是一个空集合
• 204 无内容
• 找到 200 个，且集合为空

有什么建议吗？ (请给出论据)

顺便说一句，它可能适用于分页。如果我请求第 3 页(共 2 页)，那么第 3 页将返回一个空集，它应该是 404 吗？

Answer 1

404 不是您要查找的内容。这是一个错误情况。你的情况不是一个错误。客户目前不知道有没有相关的文章，想知道。这不是一个错误。

204 也不合适。 RFC 2616 规定:

  The server has fulfilled the request but does not need to return an
  entity-body, and might want to return updated metainformation. The
  response MAY include new or updated metainformation in the form of
  entity-headers, which if present SHOULD be associated with the
  requested variant.

204 并不表明没有相关文章。它只是表示服务器不需要发送数据。

另一方面，带有空集合的

200 可以满足您的需求。