返回提交历史
Added
manga/light_card.md
+204
-0
XFEstudio/bilibili-API-collect
添加轻享卡相关接口 (#611)
* 添加：获取轻享卡信息 * 添加：领取轻享卡奖励
784585a
代码差异
1 个文件
+204
-0
@@ -0,0 +1,204 @@
1
# 获取轻享卡信息
2
3
> https://manga.bilibili.com/twirp/card.v1.Card/GetUserLightCard
4
5
*请求方式：POST*
6
7
是否需要登录：`是`
8
9
认证方式：Cookie（SESSDATA）/ APP
10
11
Content-Type：`application/x-www-form-urlencoded`
12
13
**URL参数：**
14
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
16
|------------|-----|----------------|-----|-----------------|
17
| access_key | str | 登录`access_key` | | 与`SESSDATA`二选其一 |
18
19
**json回复：**
20
21
根对象：
22
23
| 字段名 | 类型 | 内容 | 备注 |
24
|------|-----|------|------|
25
| code | num | 响应码 | 0：成功 |
26
| msg | str | | |
27
| data | obj | 信息本体 | |
28
29
`data`对象：
30
31
| 字段名 | 类型 | 内容 | 备注 |
32
|--------------------|-------|----------------|---------------------------------|
33
| state | num | 轻享卡开通状态 | 0：未开通<br/>1：已开通 |
34
| show_state | num | | |
35
| expire_date | str | 轻享卡到期时间 | |
36
| receive_amount | num | 已领取数量 | |
37
| save_money | num | 已节省漫币 | |
38
| index | num | 默认选择签到周期 | |
39
| week | array | 一个领取周期内的领取状态信息 | |
40
| month_reward_state | num | 是否可选择全勤奖 | 0：不可领取<br/>1：可领取<br/>2：不可领取（灰色） |
41
| month_reward | num | | |
42
| cur_month_end | str | 全勤奖领取剩余时间 | |
43
| server_time | str | 当前服务器时间 | |
44
45
`week`数组中的对象：
46
47
| 字段名 | 类型 | 内容 | 备注 |
48
|-------------------|-----|-------------|------------------------------------------------|
49
| index | num | 第几领取周期 | 从`1`开始 |
50
| start_time | str | 本周期领取开始时间 | 1：待领取<br/>2：已领取<br/>3：明日可领<br/>4：已失效<br/>5：可领取 |
51
| end_time | str | 本周期领取结束时间 | `同上` |
52
| first | num | 本周期第1天的领取状态 | `同上` |
53
| second | num | 本周期第2天的领取状态 | `同上` |
54
| third | num | 本周期第3天的领取状态 | `同上` |
55
| fourth | num | 本周期第4天的领取状态 | `同上` |
56
| full_reward_state | num | 周期全勤奖领取状态 | 1：不可领取<br/>2:可领取<br/>3：已领取 |
57
58
**示例：**
59
60
`SESSDATA`方式：
61
62
```shell
63
curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetUserLightCard' \
64
-H 'Cookie: SESSDATA=xxx'
65
```
66
67
`access_key`方式：
68
69
```shell
70
curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetUserLightCard?access_key=xxx'
71
```
72
73
<details>
74
<summary>查看响应示例：</summary>
75
76
```json
77
{
78
"code": 0,
79
"msg": "",
80
"data": {
81
"state": 1,
82
"show_state": 1,
83
"expire_date": "2023-03-09T23:59:59+08:00",
84
"receive_amount": 18,
85
"save_money": 890,
86
"index": 1,
87
"week": [
88
{
89
"index": 1,
90
"start_time": "2023-02-10T00:00:00+08:00",
91
"end_time": "2023-02-16T23:59:59+08:00",
92
"first": 5,
93
"second": 1,
94
"third": 1,
95
"fourth": 1,
96
"full_reward_state": 1
97
},
98
{
99
"index": 2,
100
"start_time": "2023-02-17T00:00:00+08:00",
101
"end_time": "2023-02-23T23:59:59+08:00",
102
"first": 1,
103
"second": 1,
104
"third": 1,
105
"fourth": 1,
106
"full_reward_state": 1
107
},
108
{
109
"index": 3,
110
"start_time": "2023-02-24T00:00:00+08:00",
111
"end_time": "2023-03-02T23:59:59+08:00",
112
"first": 1,
113
"second": 1,
114
"third": 1,
115
"fourth": 1,
116
"full_reward_state": 1
117
},
118
{
119
"index": 4,
120
"start_time": "2023-03-03T00:00:00+08:00",
121
"end_time": "2023-03-09T23:59:59+08:00",
122
"first": 1,
123
"second": 1,
124
"third": 1,
125
"fourth": 1,
126
"full_reward_state": 1
127
}
128
],
129
"month_reward_state": 0,
130
"month_reward": 0,
131
"cur_month_end": "2023-03-10T00:00:00+08:00",
132
"server_time": "2023-02-10T10:59:43+08:00"
133
}
134
}
135
```
136
137
</details>
138
139
# 领取轻享卡奖励
140
141
> https://manga.bilibili.com/twirp/card.v1.Card/GetLightCoupon
142
143
*请求方式：POST*
144
145
是否需要登录：`是`
146
147
认证方式：Cookie（SESSDATA）/ APP
148
149
Content-Type：`application/json`
150
151
**URL参数：**
152
153
| 参数名 | 类型 | 必填 | 内容 | 备注 |
154
|------------|-----|----|-----------------|----|
155
| access_key | str | | 与`SESSDATA`二选其一 | |
156
157
**正文参数（ application/json ）：**
158
159
| 参数名 | 类型 | 必填 | 内容 | 备注 |
160
|-----------|-----|----|-----|--------|
161
| weekIndex | num | √ | 第几周 | 从`1`开始 |
162
| type | num | √ | 第几天 | 从`1`开始 |
163
164
**json回复：**
165
166
根对象：
167
168
| 字段名 | 类型 | 内容 | 备注 |
169
|------|-----|-----|----------------------------------------------------|
170
| code | num | 响应码 | 0：成功<br/>3：今日已领取,请明日再来<br/>3：还未满足领取条件<br/>4：找不到数据~ |
171
| msg | str | | |
172
| data | obj | | |
173
174
**示例：**
175
176
`SESSDATA`方式：
177
178
```shell
179
curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetLightCoupon' \
180
-H 'content-type: application/json; charset=utf-8' \
181
-H 'Cookie: SESSDATA=xxx' \
182
--data-raw '{"type":1,"weekIndex":1}'
183
```
184
185
`access_key`方式：
186
187
```shell
188
curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetLightCoupon?access_key=xxx' \
189
-H 'content-type: application/json; charset=utf-8' \
190
--data-raw '{"type":1,"weekIndex":1}'
191
```
192
193
<details>
194
<summary>查看响应示例：</summary>
195
196
```json
197
{
198
"code": 0,
199
"msg": "",
200
"data": {}
201
}
202
```
203
204
</details>