ouzhou
766666601e
Co-authored-by: OuYingJun1024 <1034284404@qq.com> Reviewed-on: #22 Reviewed-by: marco <marco@wonderable.ai> Co-authored-by: ouzhou <ouzhou@wonderable.ai> Co-committed-by: ouzhou <ouzhou@wonderable.ai>
33 lines
891 B
Markdown
33 lines
891 B
Markdown
# 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`。
|