guke
b23335d5fb
docs: reorganize api docs into categorized subdirectories and fill missing docs - Categorize 77 existing api docs into 16 business-domain subdirectories (auth/ad/wallet/coupon/compare/savings/signin/tasks/invite/user/ device/platform/intent/meituan/other) plus admin/ and internal/ - Split admin/ into 7 sub-resource subdirectories (auth/users/wallet/ withdraws/feedbacks/admins/ad) with 4 single-file docs at root - Create 21 new docs covering 28 previously undocumented endpoints: ad/watch-report, wallet/transfer-auth (3 endpoints), coupon/session+ stats+completed-today+prompt (7), invite/me+invitees+bind+landing-track, user/onboarding (2), platform/flags+ad-config+app-version, intent/step+precoupon/step, analytics/events, order/report, report/submit+records, feedback/config+records, trace/finalize - Add mock request/response JSON examples to all new docs - Create docs/README.md with full category index for LLM navigation - Update docs/api/README.md: fix all links, add new endpoint rows, replace "no doc" markers with actual links - Fix back-navigation links (./README.md -> ../README.md or ../../README.md) in all moved files @
35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# POST /api/v1/compare/milestones/{milestone}/claim — 领取比价战绩里程碑奖励
|
||
|
||
> 所属:比价记录组（前缀 `/api/v1/compare`） | 鉴权:Bearer | [← 返回 API 索引](../README.md)
|
||
|
||
领取某一档(第 `milestone` 次)。⚠️ **当前不真发金币**(产品定,后续整体删除该功能):仍写
|
||
`comparison_milestone_claim`((user_id, milestone) 唯一)标记该档已领、**每档只能领一次**,但不调
|
||
`grant_coins`、不写 `coin_transaction`,余额不变,`coin_awarded` 恒为 0。进度口径见
|
||
[milestones 进度接口](./compare-milestones.md)。
|
||
|
||
## 入参
|
||
- 路径参数 `milestone`(int):档位序号,1..6(= `RECORD_MILESTONES` 长度)。
|
||
|
||
## 出参
|
||
响应 `200`：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `milestone` | int | 本次领取的档位序号 |
|
||
| `coin_awarded` | int | 本次发放金币(当前恒为 `0`,暂不真发) |
|
||
| `coin_balance` | int | 领奖后金币余额(当前不变) |
|
||
|
||
```json
|
||
{ "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`](./wallet-account.md))。
|
||
- 幂等:重复领同一档返回 409(唯一约束 + 领取前查重)。
|