文档 / 统一响应
统一响应
所有接口返回 JSON,业务数据放在 data 中。失败示例中的 message 为英文(默认语言);实际随 多语言 变化。
成功
{
"code": 0,
"message": "ok",
"data": [
"\/* 见各接口 response_example *\/"
]
}
失败
{
"code": 40001,
"message": "Invalid email format",
"data": null
}
字段约定
| 字段 | 类型 | 说明 |
|---|---|---|
code | int | 0 成功,非 0 失败(见错误码);不随语言变化 |
message | string | 可读说明,可直接 toast;随 lang 本地化 |
data | object|array|null | 成功时的载荷;失败多为 null |
响应头 Content-Language 为本次实际语言(如 en、ja)。