响应通用定义

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 段),含义以各接口文档为准

results matching ""

    No results matching ""