Appearance
打卡预校验接口
接口概述
- 接口名称：打卡预校验
- 接口用途：校验用户是否可对指定景点发起打卡
- 调用方：小程序前端
- 请求方式：
POST - 请求路径：
/checkins/prepare - 请求头要求：
Authorization
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| spotId | string | 是 | 景点 ID |
| routeId | string | 否 | 来源路线 ID |
| deviceModel | string | 否 | 设备型号 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| canCheckin | bool | 是否可继续 |
| reason | string | 不可继续原因 |
| rewardPoints | int | 本次可得积分 |
返回示例
成功示例
{"code":"0","message":"ok","data":{"canCheckin":true,"reason":"","rewardPoints":10}}
失败示例
接口约束
| 项目 | 说明 |
|---|---|
| 错误码说明 | A0001、A0003 |
| 幂等要求 | 否 |
| 前后端同步规则 | 仅做前置校验，不落库 |
| 缓存/刷新策略 | 不缓存 |
| 一致性要求 | 强一致 |
说明
该接口用于打卡动作前的前置校验，不负责实际打卡数据落库。前端可根据 canCheckin、reason 和 rewardPoints 决定是否允许用户继续执行打卡流程。