所有响应均为 JSON 对象,字段如下:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int | 是 | 业务状态码:0 表示成功;非 0 表示失败 |
| msg | string | 是 | 状态描述信息(成功或失败原因,部分成功场景 msg 可能为空) |
| data | object/array | 是 | 详细数据对象(不同 action 返回结构不同) |
| action | 说明 |
|---|---|
| recent | 获取最近 10 条签到记录 |
| query | 查询订单是否存在、是否已签到 |
| checkin | 按订单号签到 |
| checkin_id_card | 按身份证号签到(系统自动查该用户最后一笔订单后签到) |
| cancel | 取消签到(将订单状态改回 paid,并删除签到记录) |
请求:
{"action":"recent"}
响应(示例):
{"code":0,"msg":"","data":[{"user_id":"32","order_no":"FUT17727052167595","wx_nickname":"微信用户","phone":"15011558849","checkin_at":"2026-03-11 23:35:15"}]}
请求:
{"action":"query","order_no":"FUT17727052167595"}
响应(已签到):
{"code":0,"msg":"","data":{"exists":true,"checked_in":true,"created_at":"2026-03-11 23:35:15"}}
响应(存在但未签到):
{"code":0,"msg":"","data":{"exists":true,"checked_in":false}}
响应(订单不存在):
{"code":1,"msg":"该订单不存在","data":[]}
请求:
{"action":"checkin","order_no":"FUT17727052167595"}
自动识别签到模式请求(推荐):
{"action":"checkin","order_no":"FUT17727052167595-1774336000","auto_detect":1}
说明:
响应(成功):
{"code":0,"msg":"签到成功","data":{"rows":[{"user_id":"32","order_no":"FUT17727052167595","wx_nickname":"微信用户","phone":"15011558849","checkin_at":"2026-03-11 23:35:15"}]}}
响应(已签到):
{"code":1,"msg":"已经签到了","data":{"created_at":"2026-03-11 23:35:15","rows":[...]}}
响应(未支付):
{"code":1,"msg":"该订单未支付","data":[]}
请求:
{"action":"checkin_id_card","id_card":"11010119900307401X"}
响应(成功/已签到/失败)结构与 checkin 类似。
请求:
{"action":"cancel","order_no":"FUT17727052167595"}
响应(成功):
{"code":0,"msg":"已取消签到","data":[]}