REST api对GET的预期响应

Question

我正在制作一个REST API，我对一个没有匹配项的get通常返回什么有疑问。 例如，如果我的资源是“用户”，而我使用

http方法：GET网址：api.mysite.com/users/123

如果存在“ 123”，我将在响应正文中返回一个包含用户详细信息的http代码200。 我的问题是； 如果没有ID为123的用户，我应该返回什么http代码，应该在响应正文中放入什么？

我应该只返回代码200和一个空的正文吗？

Answer 1

使用404 ，因为请求的资源（用户）不存在。

10.4.5找不到404

服务器未找到与Request-URI匹配的任何内容 。 没有迹象表明这种情况是暂时的还是永久的。 如果服务器通过某种内部可配置的机制得知旧资源永久不可用并且没有转发地址，则应使用410（已消失）状态代码。 如果服务器不希望确切显示请求被拒绝的原因，或者没有其他响应可应用时，通常使用此状态代码。 RFC 2616

• 更好的Rest API设计2
• 找不到RESTful资源。 404或204？ Jersey从处理程序返回null时返回204
• 何时在API中使用HTTP状态代码404

Answer 2

作为它的API，您可以返回任何想要的信息，但是如果您谈论HTTP响应的标准，那么我建议您返回404 (NOT FOUND)在这种情况下看起来更合适。 因为您尝试访问的资源在该位置不可用。

404-找不到表示服务器未找到与请求URI匹配的任何内容。

使用状态码404，您还可以为响应正文或任何其他有意义的标头提供正确的错误消息。 使客户可以理解它。