Appearance
图鉴解锁接口
概述
用于根据周边芯片完成图鉴解锁，并发放对应积分奖励。
- 接口名称：图鉴解锁
- 接口用途：根据周边芯片完成图鉴解锁与积分奖励
- 调用方：小程序前端
- 请求方式：
POST - 请求路径：
/atlas/unlock
请求头
| 请求头 | 是否必填 | 说明 |
|---|---|---|
Authorization | 是 | 身份认证信息 |
X-Idempotency-Key | 是 | 幂等请求标识 |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
nfcTagId | string | 是 | 图鉴芯片标签 ID |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
atlasId | string | 图鉴 ID |
rewardGranted | bool | 是否发放奖励 |
rewardPoints | int | 奖励积分 |
成功响应示例
{"code":"0","message":"ok","data":{"atlasId":"a_1","rewardGranted":true,"rewardPoints":30}}
失败响应示例
错误码
| 错误码 | 说明 |
|---|---|
A0001 | 通用错误码 |
B1005 | 未识别到有效周边芯片，请重试 |
接口约束
- 幂等要求：是
- 缓存策略：不缓存
- 一致性要求：强一致
前后端同步规则
接口调用成功后，前端应立即执行以下刷新操作：
- 刷新图鉴列表
- 刷新积分余额