我应该在导致空集的资源上返回 404 错误吗？

问题描述

如果我有一个资源具有以下端点列出该资源中的所有项目：

/api/v1/resources

结果：

[
  {
    "id": 1,"value": -100
  },{
    "id": 2,"value": -999
  }
]

它有各种过滤器，例如：

/api/v1/resources?values_gte=999

如果过滤器排除每个资源并导致空集：

[]

我应该返回 404 状态代码还是 200 状态代码？

解决方法

我应该返回 404 状态代码还是 200 状态代码？

200

您询问了由“/api/v1/resources?values_gte=999”标识的资源的当前表示，所以这里是：一个空的 JSON array

请注意，如果有人请求 /foo.json，这正是您要执行的操作，并且您磁盘上的文件恰好包含内容 []

HTTP 状态码是识别响应语义的元数据；它们用于区分文档表示（2xx 成功）和错误表示（4xx 客户端错误）。

404 响应的有效负载将是“包含错误情况解释的表示，以及它是临时情况还是永久情况。”，而不是空文档。