Files
shaguabijia-app-server/docs/api/signin-boost.md
T
OuYingJun1024 356d6e52b9 feat(coin): 金币数值体系一期 — 签到加成 + 信息流广告结算
签到加成(boost):
- 新增 signin_boost_record 表(user+date 唯一)+ POST /api/v1/signin/boost
- signin 状态/结算逻辑调整

信息流广告结算:
- 新增 ad_feed_reward_record 表(client_event_id 幂等)+ POST /api/v1/ad/feed-reward
- ad_feed_reward 模型/repo、ad schema、按 ecpm/时长结算金币

金币数值:core/rewards.py 数值调整、config_schema/admin config 适配
迁移 coin_reward_phase1(down_revision pstat3growth);测试 + API/DB 文档同步

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-07 22:52:06 +08:00

891 B

POST /api/v1/signin/boost — 签到后看广告膨胀金币

用户当天已签到后,看完一条激励视频,补发一笔等额签到金币。

鉴权

需要 Bearer token。

请求体

字段 类型 必填 说明
ad_ref_id string|null 广告会话/交易号。当前开发期可空,后续接 S2S 后可回填

响应

字段 类型 说明
coin_awarded int 本次膨胀补发金币
coin_balance int 补发后的金币余额
signin_date string 被膨胀的签到日期,格式 YYYY-MM-DD

错误

  • 401: 未登录
  • 409: 当天未签到,或当天已经膨胀过

数据写入

  • signin_boost_record 新增一行,用 (user_id, signin_date) 唯一约束防重复。
  • coin_account 增加余额。
  • coin_transaction 写入 biz_type=signin_boost