部分成功的 REST API 响应

Question

我有一个 API 可以执行一些批量处理任务。假设它对某些资源进行命名。

我批量通过了 7 个请求，其中 5 个更新成功，2 个失败。

我的问题是如何处理响应。使用 HTTP 我不能同时返回成功和错误。

有一个部分成功的 HTTP 代码，但我需要一次返回所有资源的单独响应。无论如何我们可以做到吗？

Answer 1

您可以使用 207 MULTI-STATUS 获取 http 状态 在多个状态代码可能适用的情况下，多状态响应传达有关多个资源的信息。

默认的多状态响应正文是具有“多状态”根元素的 HTTP 实体。其他元素包含在方法调用期间生成的 200、300、400 和 500 系列状态代码。

您可以在响应正文中包含一组响应对象，这些对象可能有自己的状态代码

示例

HTTP 207

{
    "data": [
        {
            "messgage": "success",
            "resource": {
                "foo": "bar",
                "id": "1d1"
            },
            "status": 200
        },
        {
            "messgage": "Requested resource or subresource not found ",
            "resource": null,
            "status": 404
        },
        {
            "messgage": "success",
            "resource": {
                "foo": "bars",
                "id": "1d2"
            },
            "status": 200
        }
    ],
    "metadata": {
        "failure": 1,
        "success": 2,
        "total": 3
    }
}