guke
a563c1ca4b
docs/api目录文档分类和补全 --------- Co-authored-by: guke <guke@autohome.com.cn> Reviewed-on: #111
24 lines
779 B
Markdown
24 lines
779 B
Markdown
# POST /api/v1/signin — 执行今日签到
|
||
|
||
> 所属:Signin 组（前缀 `/api/v1/signin`,本接口 POST 到前缀本身） | 鉴权:Bearer | [← 返回 API 索引](../README.md)
|
||
|
||
## 入参
|
||
无（用户由 token 确定）。
|
||
|
||
## 出参
|
||
响应 `200`:`SigninResultOut`
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `coin_awarded` | int | 本次签到发放金币 |
|
||
| `cycle_day` | int | 本次签到落在 14 天循环第几天 |
|
||
| `streak` | int | 签到后的连续天数 |
|
||
| `coin_balance` | int | 签到后金币余额 |
|
||
|
||
## 错误码
|
||
- `409` 今日已签（`already signed today`）
|
||
|
||
## 说明
|
||
发金币已计入 [wallet-account](./wallet-account.md) 的余额（客户端就地刷新即可,不必另叠）。
|
||
断签后从第 1 天重新开始;第 15 天回到第 1 天。
|