REST API响应的正确方式是什么？

Question

什么是REST API响应结构和布局的最佳实践？

Scrath示例：

成功回应：

{
    "status": "success",
    "data": # some data here
}

失败响应：

{
    "status": "fail",
    "data": {
        "code": # some error code,
        "message": # some error explaining message
    }
}

Answer 1

有很多方法可以设计API响应。它取决于您的架构、技术和其他方面。

根据你的例子，我会这样回答

成功请求：

{
    "status": "success",
    "data": {
            /* Application-specific data would go here. */
    },
    "message": null /* Or optional success message */
}

{
    "status": "error",
    "code": 404,
    "data": null, /* or optional error payload */
    "message": "Error xyz has occurred"
}