Files

T

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
@

2026-07-03 14:56:50 +08:00

2.4 KiB

Raw Permalink Blame History

POST /api/v1/ad/feed-reward — 信息流广告完成后结算金币

点位 2：比价等待 / 领券信息流广告（轮播多条）。整场比价全程不关广告才发，金额按整场总观看时长折份（每 10 秒 1 份），结束时一次性入账。用户中途 ✕ 关闭则整场不发。

鉴权

需要 Bearer token。

请求体

字段	类型	必填	说明
`client_event_id`	string	是	客户端生成的幂等事件 id，8-64 字符
`ad_session_id`	string\|null	否	客户端生成的一次信息流广告会话 id，用于对账/排查
`ecpm`	string	是	本场信息流 eCPM 代表值(穿山甲 getEcpm 原值)，按“分/千次展示”处理(非元)
`duration_seconds`	int	是	整场累计观看秒数(轮播各条相加)
`adn`	string\|null	否	实际投放 ADN(聚合后实际填充的子渠道)
`slot_id`	string\|null	否	实际展示代码位(底层 mediation rit)
`app_env`	string\|null	否	我们的应用环境:`prod`(傻瓜比价正式) / `test`(测试应用)
`our_code_id`	string\|null	否	我们后台配置的代码位 ID(104xxx,非底层 rit);供广告收益报表按代码位聚合金币
`aborted`	bool	否	用户中途 ✕ 关闭广告(未走完比价):整场不发，仅记 `closed_early`。默认 `false`

响应

字段	类型	说明
`granted`	bool	本次是否入账；未发(任一非 granted 状态)时为 `false`
`status`	string	`granted`(已发) / `capped`(当日次数超限) / `too_short`(整场总时长<10s 凑不满一份) / `closed_early`(用户中途关闭)
`coin`	int	本次发放金币；非 granted 为 0
`unit_count`	int	按 10 秒折算出的奖励份数
`daily_limit`	int	每日信息流展示次数上限，默认 500

计算口径

奖励份数：整场总时长 // 10。
单份奖励：eCPM / 1000 × 因子1(eCPM 档) × 因子2(当天累计份序号) × 10000，四舍五入为整数金币。
eCPM 档：0-100=0.1，101-200=0.3，201-400=0.4，>400=0.6。
LT 档：第 1 份 2.0，第 2 份 1.5，第 3 份 1.3，第 4-10 份 1.1，第 11 份及以后 1.0。

数据写入

ad_feed_reward_record 新增一行。
入账时 coin_account 增加余额。
入账时 coin_transaction 写入 biz_type=feed_ad_reward。

2.4 KiB Raw Permalink Blame History Unescape Escape

POST /api/v1/ad/feed-reward — 信息流广告完成后结算金币

鉴权

请求体

响应

计算口径

数据写入

2.4 KiB

Raw Permalink Blame History