签到接口说明
第三方接口调用规范文档
返回签到

第三方接口调用规范文档(签到 Qiandao)

1. 基本信息

2. 通用返回结构

所有响应均为 JSON 对象,字段如下:

字段类型必填说明
codeint业务状态码:0 表示成功;非 0 表示失败
msgstring状态描述信息(成功或失败原因,部分成功场景 msg 可能为空)
dataobject/array详细数据对象(不同 action 返回结构不同)

3. API 列表

action说明
recent获取最近 10 条签到记录
query查询订单是否存在、是否已签到
checkin按订单号签到
checkin_id_card按身份证号签到(系统自动查该用户最后一笔订单后签到)
cancel取消签到(将订单状态改回 paid,并删除签到记录)

4. 获取最近记录(recent)

请求:

{"action":"recent"}

响应(示例):

{"code":0,"msg":"","data":[{"user_id":"32","order_no":"FUT17727052167595","wx_nickname":"微信用户","phone":"15011558849","checkin_at":"2026-03-11 23:35:15"}]}

5. 查询订单签到状态(query)

请求:

{"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":[]}

6. 按订单号签到(checkin)

请求:

{"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":[]}

7. 按身份证号签到(checkin_id_card)

请求:

{"action":"checkin_id_card","id_card":"11010119900307401X"}

响应(成功/已签到/失败)结构与 checkin 类似。

8. 取消签到(cancel)

请求:

{"action":"cancel","order_no":"FUT17727052167595"}

响应(成功):

{"code":0,"msg":"已取消签到","data":[]}

9. 参数限制与建议