REST API 404:坏的URI，或缺少资源?

我正在构建一个REST API，但遇到了一个问题。

在设计REST API时，公认的做法似乎是，如果所请求的资源不存在，就会返回404。

然而，对我来说，这增加了不必要的模糊性。HTTP 404通常与错误的URI联系在一起。所以实际上我们在说:“要么你去了正确的地方，但那个特定的记录不存在，要么互联网上没有这样的位置!我真的不知道是哪一个……”

考虑下面的URI:

http://mywebsite/api/user/13

如果我得到404返回，是因为用户13不存在吗?还是因为我的URL应该是:

http://mywebsite/restapi/user/13

在过去，如果记录不存在，我只是返回一个带有HTTP 200 OK响应代码的NULL结果。它很简单，在我看来非常干净，即使它不一定是公认的实践。但是有没有更好的办法呢?

当前回答

404只是HTTP响应代码。在此基础上，您可以提供一个响应体和/或其他带有开发人员将看到的更有意义的错误消息的报头。

其他回答

404只是HTTP响应代码。在此基础上，您可以提供一个响应体和/或其他带有开发人员将看到的更有意义的错误消息的报头。

这篇古老但优秀的文章……http://www.infoq.com/articles/webber-rest-workflow是这么说的…

404 Not Found——服务太懒惰(或者太安全)了，不能给我们一个请求失败的真实原因，但是不管是什么原因，我们都需要处理它。

统一资源标识符是指向资源的唯一指针。格式较差的URI不指向资源，因此对其执行GET操作将不会返回资源。404表示服务器没有找到任何与请求uri匹配的内容。如果你输入了错误的URI或坏的URI，这就是你的问题，也是你无法访问资源的原因，无论是HTML页面还是IMG。

由于这个讨论似乎能够在时间结束时幸存下来，我将抛出JSON:API规范

404未找到服务器在处理获取不存在的单个资源的请求时必须响应404 Not Found，除非请求保证200 OK响应并以null作为主要数据(如上所述)。

HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "links": {
    "self": "http://example.com/articles/1/author"
  },
  "data": null
}

也请看看这个Stackoverflow问题

这是我们团队最近提出的。我们使用404 Not found与消息体和204 No Content基于下面的理由。

如果请求URI表示单个资源的位置，则使用404 Not found。当请求查询一个URI时，我们使用204 No Content

当用户13不存在时，http://mywebsite/api/user/13将返回404 http://mywebsite/api/users?id=13将返回204 no内容 http://mywebsite/api/users?firstname=test将返回204 no内容

这里的想法是，“查询路由”被期望能够返回1，许多或没有内容。

无论你选择哪种模式，最重要的是保持一致——所以要得到你的团队的认可。

推荐文章