周救济金接口
weekly_rescue_bonus
周救济金的 list / detail / claim 走通用活动接口(kind=weekly_rescue_bonus,详见 活动接口)。每周到 dispatch_weekday + dispatch_hour 后结算上一完整 ISO 周(周一 0 点到下周一 0 点)净损,命中阶梯则按 loss * rate% 发奖。
活动详情字段
通用接口 GET /promotion/weekly_rescue_bonus/detail 的 data 字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| content | string | 活动说明 |
| config | list<Tier> | 阶梯配置(按 loss 升序) |
| can_be_collected | bool | 是否可立即领取(启用 + 已过本周发放时点 + 命中阶梯 + 未领) |
| bonus | number | 本期可领(或已领)金额 |
| loss_amount | number | 本期净损 |
| this_week_bonus | number | 本周实时净损对应的预计奖金(独立于发放时点) |
| this_week_loss | number | 本周实时净损(自本周一 0 点至今) |
Tier 字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| loss | string | 阶梯下限净损 |
| rate | string | 返奖百分比 |
| level | number | 阶梯序号(从 1 开始) |
未登录时所有动态字段为零值。
状态码(gamePayload)
| 字段 | 含义 |
|---|---|
status=0 |
无可领(未到时点 / 净损未命中) |
status=1 |
本期可领 |
status=2 |
本期已领 |
附加字段:dispatch_weekday(1 = 周一)、dispatch_hour(小时)、expires_next_week(是否次周过期)。
领取
通用接口 POST /promotion/weekly_rescue_bonus/claim。需当前已过本周发放时点且上一完整 ISO 周净损命中阶梯;本期重复领取由唯一约束拦截。
输入: {}
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| amount | number | 入账金额 |