针对部分故障并要求客户重新尝试的API响应的行业实践

Question

用例：，我正在设计一个更新API，外部客户端可以传递资源信息(以JSON格式)来持久化。以较小资源的形式将整个资源持久化为多个下行流(并行)。因此，如果任何一个下游关闭，我计划返回5XX http响应代码，以确保客户端重试。但同时，要确保客户端知道资源的哪一部分是成功的。

我研究了关于HTTP代码( 207和202 )的其他类似问题(Q1，Q2)，但它们不适用于我的用例，因为这不是一个批处理请求，整个资源可以划分为外部客户端的较小资源。据我理解，202适用于异步处理场景，在这种情况下，我们能够接受请求，并且仍然在处理，而在我的情况下，我希望确保客户端知道请求失败，并且应该重试。

方法被认为是，我计划将HTTP代码作为5XX返回，但同时将资源的一部分(JSON格式)添加到成功的响应中。

我想知道上述方法是否从行业标准中被接受，以及是否有人已经解决了这样的用例。

Answer 1

老实说，你已经谈到了次级资源、部分成功和能够重试失败的资源。所有这些特性在HTTP中都是完全可用的，如果您再执行一个步骤:将请求拆分为多个请求，这些特性将非常好地工作。