当依赖/下游（如 3rd 方 API）失败时使用什么 HTTP 状态代码？

Question

我们的 API 中有一个路由（在调用时）会访问另一个 3rd 方 API。

例如

HTTP-GET /account/1

这会从我们的数据库和 .. 比如说 .. 一个 Auth0/Okta/SalesForce/whatever 等第 3 方 api 返回一些数据。

现在，如果此第 3 方 api 调用因任何原因失败（失败 == 4**、5** 甚至 200 OK，但内容是一些错误消息），那么我应该将什么错误状态代码传递回客户端调用我的 API？

最初我在想HTTP-500-Server-Error，但是...我现在不太确定，因为如果我将一个好的错误消息返回给客户。所以我想，返回一个HTTP-200-OK，其中包含下游问题/错误的一些键/值......但这真的 OK（双关语）。对我来说，HTTP-200-OK 就像返回的答案是真的 好的。

所以我不确定人们在这种情况下会做什么。

我觉得HTTP-500 是针对发生但尚未真正处理和/或解释的错误。

Answer 1

现在，如果此第 3 方 api 调用因任何原因失败（失败 == 4**、5** 甚至 200 OK，但内容是一些错误消息），那么我应该将什么错误状态代码传递回客户端调用我的 API？

API 应该从消费者的角度来设计。在大多数情况下，API 使用者不会关心请求是否由他们向下游服务器发出请求的服务器或由下游服务器完成。

如果对下游服务器的请求阻止您的服务器完成客户端请求，您可以选择500 或503。或者，您可以返回一些缓存数据（如果有的话）并返回2xx 状态码。