ouzhou
da7ce69494
- 新增 POST /api/v1/ad/ecpm-report:激励视频展示后客户端上报本次 eCPM,落 ad_ecpm_record 做内部收益统计(model/repository/schema/alembic 迁移 + 接口文档) - 看广告冷却策略抽到 app/core/ad_cooldown.py 纯函数;ad_reward.today_status 只取数据,换策略只改这一处 - savings.dishes 改 JSON().with_variant(JSONB,"postgresql"):SQLite 无 visit_JSONB 会让 create_all 编译崩,修复后测试套件恢复 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: OuYingJun1024 <1034284404@qq.com> Reviewed-on: #8 Co-authored-by: ouzhou <ouzhou@wonderable.ai> Co-committed-by: ouzhou <ouzhou@wonderable.ai>
52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# GET /api/v1/compare/milestones — 比价战绩里程碑进度
|
||
|
||
> 所属:比价记录组（前缀 `/api/v1/compare`） | 鉴权:Bearer | [← 返回 API 索引](./README.md)
|
||
|
||
福利页「记录比价战绩」的数据源。返回各档(第 1~6 次)解锁/领取状态。
|
||
|
||
**解锁进度** = 当前用户 `comparison_record` 里 `status='success'` 的条数(只算成功比价,失败的不计入)。第 N 档在「成功比价次数 ≥ N」时解锁;每档领一次(领取见 [claim 接口](./compare-milestone-claim.md))。
|
||
|
||
档位金额是**产品规则**,定义在后端 `app/core/rewards.py` 的 `RECORD_MILESTONES`(当前 `120/180/300/500/800/1200`),客户端**不要写死**,以本接口返回为准。
|
||
|
||
## 入参
|
||
无(用户身份取自 Bearer token)。
|
||
|
||
## 出参
|
||
响应 `200`：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `success_count` | int | 累计成功比价次数(解锁进度) |
|
||
| `claimable_count` | int | 当前可领(state=active)的档数 |
|
||
| `milestones` | Milestone[] | 各档状态,按 milestone 升序 |
|
||
|
||
**Milestone**
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `milestone` | int | 档位序号(1-based),= 解锁所需的成功比价次数 |
|
||
| `coin` | int | 该档奖励金币 |
|
||
| `state` | string | `claimed`(已领) / `active`(已解锁可领) / `locked`(未解锁) |
|
||
|
||
```json
|
||
{
|
||
"success_count": 2,
|
||
"claimable_count": 1,
|
||
"milestones": [
|
||
{"milestone": 1, "coin": 120, "state": "claimed"},
|
||
{"milestone": 2, "coin": 180, "state": "active"},
|
||
{"milestone": 3, "coin": 300, "state": "locked"},
|
||
{"milestone": 4, "coin": 500, "state": "locked"},
|
||
{"milestone": 5, "coin": 800, "state": "locked"},
|
||
{"milestone": 6, "coin": 1200, "state": "locked"}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 错误
|
||
- `401` 未鉴权
|
||
|
||
## 说明
|
||
- 同时可有多档处于 `active`(如累计 3 次却一档没领,则前 3 档都可领),逐档调 claim。
|
||
- 进度只增不减:领取不消耗成功次数,只是把对应档从 active→claimed。
|