OuYingJun1024
78cd4c2696
- 签到发奖 remark='每日签到 第N天';看视频发奖 remark='看视频奖励金币'(原'看广告奖励') - 比价战绩里程碑领取暂不真发金币(产品定,后续删该功能):仍记领取/标记已领,但不调 grant_coins、余额不变、coin_awarded 恒 0 - 同步 test_compare_milestone(领取后余额不变/coin_awarded==0) + docs/api/compare-milestone-claim Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
POST /api/v1/compare/milestones/{milestone}/claim — 领取比价战绩里程碑奖励
所属:比价记录组（前缀
/api/v1/compare） | 鉴权:Bearer | ← 返回 API 索引
领取某一档(第 milestone 次)。⚠️ 当前不真发金币(产品定,后续整体删除该功能):仍写
comparison_milestone_claim((user_id, milestone) 唯一)标记该档已领、每档只能领一次,但不调
grant_coins、不写 coin_transaction,余额不变,coin_awarded 恒为 0。进度口径见
milestones 进度接口。
入参
- 路径参数
milestone(int):档位序号,1..6(=RECORD_MILESTONES长度)。
出参
响应 200：
| 字段 | 类型 | 说明 |
|---|---|---|
milestone |
int | 本次领取的档位序号 |
coin_awarded |
int | 本次发放金币(当前恒为 0,暂不真发) |
coin_balance |
int | 领奖后金币余额(当前不变) |
{ "milestone": 1, "coin_awarded": 0, "coin_balance": 29087 }
错误
401未鉴权404档位越界(unknown milestone,milestone < 1 或 > 档位总数)409该档还没解锁(milestone locked,成功比价次数 < milestone)409该档已领过(milestone already claimed)
说明
- 当前不发金币,客户端领取后只需把本档状态刷成 claimed 即可;若后续恢复发奖,再按
coin_awarded刷新钱包余额(GET /api/v1/wallet/account)。 - 幂等:重复领同一档返回 409(唯一约束 + 领取前查重)。