所有响应均为 JSON 对象,字段如下:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int | 是 | 状态码:0 表示处理成功;非 0 表示处理失败 |
| msg | string | 是 | 状态描述信息(成功或失败原因) |
| data | object | 是 | 详细数据对象(成功时可包含业务数据;失败时可包含错误详情) |
示例:
{"code":0,"msg":"成功","data":{"id":123,"order_no":"VIP17735800121793563"}}
失败示例:
{"code":1,"msg":"失败","data":{"err":"请刷新二维码"}}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 第三方传入的 key。当前系统按订单号处理(即:key=订单号) |
请求示例:
POST /gate/api/gate/ HTTP/1.1
Host: 2026.aihelper365.cn
Content-Type: application/json; charset=utf-8
{"key":"VIP17735800121793563"}
成功响应:
{"code":0,"msg":"成功","data":{"id":123,"order_no":"VIP17735800121793563"}}
失败响应(未找到签到记录):
{"code":1,"msg":"失败","data":{"err":"请刷新二维码"}}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 与 POST 的 key 含义一致(当前按订单号处理) |
请求示例:
GET /gate/api/gate/?key=VIP17735800121793563 HTTP/1.1
Host: 2026.aihelper365.cn
返回结构与 POST 一致。
| code | msg | data.err | 说明 |
|---|---|---|---|
| 0 | 成功/开门成功 | - | 已通过校验,并记录开门日志 |
| 1 | 失败 | 请刷新二维码 | 未签到或校验失败(需要刷新二维码/更换有效 key) |
| 1 | 参数无效 | key 无效 / 缺少 key 或 action | 参数缺失或不合法 |
| 1 | 请求方法不支持 | 必须使用POST或GET | 请求方法不符合要求 |
| 1 | 请求格式错误 | Content-Type 必须为 application/json | POST 时 Content-Type 不正确 |
| 500 | 服务器错误/系统错误 | server error/system error | 服务端异常 |