Skip to content

统一响应格式

开放接口使用标准 HTTP 状态码,同时 body 中通过 code 字段提供更细粒度的错误分类。

3.1 成功响应

HTTP/1.1 200 OK
json
{
    "code": 200,
    "message": "success",
    "data": { ... }
}

3.2 分页响应

对于列表查询接口,data 结构为:

json
{
    "code": 200,
    "message": "success",
    "data": {
        "list": [ ... ],
        "total": 156
    }
}

3.3 错误响应

HTTP/1.1 401 Unauthorized
json
{
    "code": 40101,
    "message": "签名验证失败",
    "data": null
}

艾恋相亲 SaaS 平台