guke
a563c1ca4b
docs/api目录文档分类和补全 --------- Co-authored-by: guke <guke@autohome.com.cn> Reviewed-on: #111
1.3 KiB
1.3 KiB
GET /api/v1/savings/battle — 省钱战绩
所属:Savings 组（前缀
/api/v1/savings） | 鉴权:Bearer | ← 返回 API 索引
入参
无（用户由 token 确定）。
出参
响应 200:SavingsBattleOut
| 字段 | 类型 | 说明 |
|---|---|---|
week_saved_cents |
int | 本周已省（分） |
beat_percent |
int | 超过百分之多少用户 |
streak_days |
int | 连续省钱天数 |
compare_count |
int | 累计完成比价次数（= 真实 compare 上报记录数；无记录为 0） |
说明
下单成交口径（savings_record 源）的战绩字段。compare_count 与 /summary 的 order_count 同源（均 = 真实下单上报记录数）。
⚠️ 2026-06 起停用 demo 兜底：只计真实比价下单上报（
source='compare'）。下单上报链路已通（AndroidPriceBotService→POST /api/v1/order/report）。
⚠️ 「我的」页省钱战绩卡已不读本接口：#23 起卡改为比价口径，「完成比价 / 累计发现可省」走
GET /api/v1/compare/stats（comparison_record，比过价就计、不要求下单），「赚取金币」走/wallet/account.total_coin_earned。本/battle（及compare_count/week_saved_cents/beat_percent/streak_days）现仅供订单口径/历史用途，不上战绩卡。