响应通用定义
1. 统一响应格式
本平台所有响应均统一包装为以下格式,HTTP 状态码恒返回 200,业务成败通过 code 字段区分:
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Long | 0 表示成功,其余均为失败,具体含义见错误码 |
| message | String | 提示信息,可能会根据需要变更,请以 code 值为准 |
| data | Object/Array | 业务数据,失败时通常为 null |
成功响应示例:
{
"code": 0,
"message": "success",
"data": {
"orderSn": "210000001000001"
}
}
失败响应示例:
{
"code": 41101,
"message": "签名验证失败",
"data": null
}
2. 通用说明
- 响应数据中涉及金额的部分,单位均为"分"
- 响应数据中涉及时间戳的部分,单位均为"毫秒"
- 部分接口错误码见业务文档(如订单业务
5xxxx段),含义以各接口文档为准