Appearance
解锁路线徽章接口
概述
用于在路线完成后发放对应徽章及额外积分。
- 接口名称：解锁路线徽章
- 接口用途：在路线完成后发放徽章和额外积分
- 调用方：小程序前端
- 请求方式：
POST - 请求路径：
/routes/{routeId}/badge-unlock
请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | 身份认证信息 |
X-Idempotency-Key | 是 | 幂等请求标识 |
请求参数
Path 参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
routeId | string | 是 | 路线 ID |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
badgeId | string | 徽章 ID |
bonusPoints | int | 额外积分 |
unlockTime | string | 解锁时间 |
成功响应示例
{"code":"0","message":"ok","data":{"badgeId":"b_1","bonusPoints":50,"unlockTime":"2026-04-10T11:00:00+08:00"}}
失败响应示例
错误码
| 错误码 | 说明 |
|---|---|
A0001 | 通用错误码 |
B1006 | 当前路线尚未完成全部打卡 |
幂等要求
该接口要求幂等。
- 请求头中必须携带
X-Idempotency-Key - 若徽章已解锁，重复请求应返回最新状态
前后端同步规则
调用成功后，前端需同步刷新以下数据：
- 路线详情
- 徽章列表
- 积分余额
- 系统消息
缓存与一致性
- 缓存策略：不缓存
- 一致性要求：强一致