RESTful API 响应状态码消歧

Question

我正在开发一个 RESTful API，并且对某些场景最合适的响应状态代码有疑问。

考虑客户端对资源发出 GET 请求的情况。对于资源合法不存在的情况，与可能存在轻微服务中断（在部署期间等）的情况，我如何消除“未找到”响应的歧义。

Answer 1

W3C 为您能想到的几乎所有情况定义了very specific status codes。满足您的特定需求：

• 未找到：404
• 服务不可用：503

Answer 2

发送“未找到”的 404 状态代码

发送一些500-series error 以了解服务器端的错误情况。