Files
shaguabijia-app-server/docs/api/compare-stats.md
T
ouzhou 766666601e feat(platform): 首页门面三统计 + 运营后台展示模式配置 (#22)
Co-authored-by: OuYingJun1024 <1034284404@qq.com>
Reviewed-on: #22
Reviewed-by: marco <marco@wonderable.ai>
Co-authored-by: ouzhou <ouzhou@wonderable.ai>
Co-committed-by: ouzhou <ouzhou@wonderable.ai>
2026-06-07 23:17:27 +08:00

1.4 KiB
Raw Permalink Blame History

GET /api/v1/compare/stats — 比价口径战绩(「我的」页省钱战绩卡)

所属:比价记录组(前缀 /api/v1/compare | 鉴权:Bearer | ← 返回 API 索引

入参

无(用户由 token 确定)。

出参

响应 200:CompareStatsOut

字段 类型 说明
compare_count int 累计完成比价次数(comparison_recordstatus='success' 的记录数)
discovered_saved_cents int 累计发现可省额(分;各成功比价 saved_amount_cents=源价−最低价 之和,null 不计)

说明

「我的」页省钱战绩卡的数据源(比价口径):

  • 卡主额「累计发现可省 ¥X」← discovered_saved_cents
  • 卡三列之「完成比价(次)」← compare_count
  • 卡「未比价锁定态」判据:compare_count == 0(没比过价 → 盖锁定蒙层,引导「立即开始」去首页比价)

⚠️ 与下单口径解耦:本接口只看「比过价」(comparison_record)不要求下单。区别于 savings_record(下单成交记账,见 savings-summary / savings-records)——那是订单记录/省钱明细的源。两表互不喂数据。

卡另两项数据源:「赚取金币」← GET /wallet/account.total_coin_earned;「领取优惠券」后端暂无累计字段(前端先占位)。