请求域名#
| 环境 | API 域名 |
|---|
| 开发环境 | https://dev-api.open.xinleshan.cn |
| 生产环境 | https://api.open.xinleshan.cn |
返回结构#
接口统一使用 JSON 格式返回，通过 success 字段判断请求是否成功。1. 返回示例#
{
"success": true,
"code": 0,
"message": "登录成功",
"data": {},
"request_id": "019ae3df-a5ce-7184-a319-0c1ec8fb9d75"
}
2. 响应参数说明#
| 字段 | 类型 | 说明 |
|---|
| success | Boolean | 请求状态。
true: 请求成功，解析 data 数据。
false: 请求失败，根据 code/message 处理错误。 |
| code | Integer | 业务状态码。用于辅助判断业务逻辑状态（详见下表）。 |
| message | String | 提示信息。面向开发者的调试信息或面向用户的提示语。 |
| data | Object/Array | 业务数据。请求成功时返回的具体内容。 |
| request_id | String | 请求 ID。用于日志排查，每次请求唯一。 |
3. 业务状态码 (code)#
当 success 为 false 时，可参考 code 进行具体业务处理：| code | 状态 | 描述 |
|---|
| 0 | 成功 | 逻辑正常 (success 为 true) |
| 1 | 常规错误 | 参数错误或业务逻辑失败，请直接展示 message |
| -1 | 登录失效 | Token 无效或已过期，需要重新登录 |
提示：request_id 在所有接口均会返回，遇到问题反馈时请务必提供此 ID。
测试付款码#
