Appearance
统一响应格式
开放接口使用标准 HTTP 状态码,同时 body 中通过 code 字段提供更细粒度的错误分类。
3.1 成功响应
HTTP/1.1 200 OKjson
{
"code": 200,
"message": "success",
"data": { ... }
}3.2 分页响应
对于列表查询接口,data 结构为:
json
{
"code": 200,
"message": "success",
"data": {
"list": [ ... ],
"total": 156
}
}3.3 错误响应
HTTP/1.1 401 Unauthorizedjson
{
"code": 40101,
"message": "签名验证失败",
"data": null
}