DDWiki/专题/后端/2020.12.1后端接口格式.md

正常响应

{
    "version": "1.0.0.0",
    "code": 200,
    "message": "this is message",
    "isError": false,
    "data": {
        "id": 1,
        "name": "name",
        "age": 21
    }
}

异常响应

{
    "version": "1.0.0.0",
    "code": 500,
    "isError": true,
    "responseException": {
        "exceptionMessage": "Unhandled Exception occurred. Unable to process the request."
    }
}

入参字段不符合要求响应

{
    "version": "1.0.0.0",
    "code": 400,
    "isError": true,
    "responseException": {
        "exceptionMessage": "Request responded with one or more validation errors occurred.",
        "validationErrors": [
            {
                "name": "Name",
                "reason": "最大长度5"
            },
            {
                "name": "Location",
                "reason": "最大长度5"
            }
        ]
    }
}

code状态码一栏表

状态码类型：

• 1**：服务器收到，客户端继续操作
• 2**：服务端处理成功
• 3**：服务端重定向
• 4**：客户端错误
• 5**：服务端错误

状态码：

• 200：服务端确认客户端请求成功，一般用于GET和POST请求
• 201：服务端创建资源成功
• 204：服务端没有内容返回
• 404：客户端要找的资源不存在
• 412：客户端先决条件错误
• 413：客户端请求实体过大
• 414：客户端请求URL过长
• 415：客户端媒体格式不对
• 419：客户端身份验证超时
• 422：客户端实体验证失败
• 429：客户端请求过多
• 431：客户端请求头过大
• 500：服务端内部错误
• 501：服务端不支持的请求
• 502：服务端收到来自远端的无效响应
• 503：服务端无法处理客户端请求
• 505：服务端不支持请求的HTTP协议版本