通过 RESTful API 报告服务状态时使用什么 HTTP 状态代码？

Question

我正在创建一个 RESTful API，它允许客户端检查当前是否正在运行特定服务。 编辑：请求地址看起来像这样 - /services/123/running

可能的返回值是：

1. OK (HTTP 200)- 服务存在并且正在运行
2. 未运行 (HTTP ???) - 服务存在，但未运行
3. 未找到 (HTTP 404) - 服务不存在

应该使用什么 HTTP 状态码来通知客户端该服务确实存在，但目前没有运行？

编辑：经过更多研究，我发现了一个关于同一主题的 stackoverflow 讨论 – What is the appropriate HTTP status code response for a general unsuccessful request (not an error)?

Answer 1

您不想为此使用 HTTP 状态代码。它们将表明请求是如何进行的。

相反，您应该在响应正文中传递状态。如果请求（检查服务状态）正常，那么 HTTP 状态码应该始终为 200，唯一不同的应该是正文。

例子：

服务存在并正在运行

Status code 200 Ok
Body {"status": "exists and running"}

服务存在，但没有运行

Status code 200 Ok
Body {"status": "exists, not running"}

服务不存在

Status code 200 Ok
Body {"status": "doesn't exist"}