Files
shaguabijia-app-server/docs/api/signin-boost.md
T
ouzhou d7c29c0883 feat(coin): 金币数值体系二期——看广告按 eCPM 发奖 + ad_session_id 幂等 + 签到膨胀固定金币 (#28)
- rewards: 激励视频实发改按 calculate_ad_reward_coin(eCPM, 当日第N次) 公式;AD_REWARD_COIN/MAX_AD_REWARD_COIN 降为历史兼容口径;新增 SIGNIN_BOOST_COIN=2000

- 签到膨胀: Day1-13 看完激励视频额外发固定金币、Day14 不允许 (signin.py / signin-boost)

- ad_session_id 幂等: ad_ecpm/ad_reward/ad_feed_reward 记录加 ad_session_id 列 + 唯一索引(新迁移 coin_reward_phase2 / ad_feed_reward_session)

- ad.py + schemas + repositories: ecpm-report / feed-reward / reward-status / test-grant 改造;config_schema 增 signin_boost_coin;admin stats overview 补充

- 同步 docs/api + docs/database + docs/integrations/pangle 及 tests(test_ad_reward / test_welfare)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: OuYingJun1024 <1034284404@qq.com>
Reviewed-on: #28
Co-authored-by: ouzhou <ouzhou@wonderable.ai>
Co-committed-by: ouzhou <ouzhou@wonderable.ai>
2026-06-09 01:56:47 +08:00

1.2 KiB

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

用户 Day1-Day13 当天已签到后,看完一条激励视频,由穿山甲 S2S 回调固定补发 2000 金币。本接口只用于 S2S 发奖后的确认。

鉴权

需要 Bearer token。

请求体

字段 类型 必填 说明
ad_ref_id string 穿山甲 S2S 回调的 trans_id。回调需先以 extra.reward_scene=signin_boost 完成发奖

响应

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

错误

  • 401: 未登录
  • 409: 缺少/无效广告回调记录,非本人广告,回调未发奖,当天未签到,Day14,或当天已经膨胀过

数据写入

  • 本接口不直接发奖;实际写入发生在 /ad/pangle-callbackreward_scene=signin_boost 分支。
  • 回调写 signin_boost_record 新增一行,用 (user_id, signin_date) 唯一约束防重复。
  • 回调使 coin_account 增加固定 2000 金币。
  • 回调写入 coin_transaction.biz_type=signin_boost