# 周救济金接口

**weekly_rescue_bonus**

周救济金的 `list` / `detail` / `claim` 走通用活动接口（`kind=weekly_rescue_bonus`，详见 [活动接口](400_promotion.md)）。每周到 `dispatch_weekday + dispatch_hour` 后结算上一完整 ISO 周（周一 0 点到下周一 0 点）净损，命中阶梯则按 `loss * rate%` 发奖。

---

## 活动详情字段 {#detail}

通用接口 `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`（是否次周过期）。

---

## 领取 {#claim}

通用接口 `POST /promotion/weekly_rescue_bonus/claim`。需当前已过本周发放时点且上一完整 ISO 周净损命中阶梯；本期重复领取由唯一约束拦截。

**输入:** `{}`

**输出:**

字段 | 类型 | 说明
---|---|---
amount | number | 入账金额