返回提交历史
Modified
README.md
+3
-2
Added
docs/electric/monthly.md
+373
-0
XFEstudio/bilibili-API-collect
update
e4e930d
代码差异
2 个文件
+376
-2
@@ -168,8 +168,9 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
168
168
- [x] [实时广播（通讯协议）](docs/broadcast)
169
169
- [x] [视频内广播](docs/broadcast/video_room.md)
170
170
- [ ] [充电](docs/electric)
171
- [x] [B币方式](docs/electric/Bcoin.md)
172
- [x] [微信 & 支付宝方式](docs/electric/WeChat&Alipay.md)
171
- [ ] [包月充电操作](docs/electric/monthly.md)
172
- [x] [自定义充电（B币方式）](docs/electric/Bcoin.md)
173
- [x] [自定义充电（微信 & 支付宝方式）](docs/electric/WeChat&Alipay.md)
173
174
- [x] [充电留言](docs/electric/charge_msg.md)
174
175
- [x] [充电列表](docs/electric/charge_list.md)
175
176
- [ ] [动态](docs/dynamic)
@@ -0,0 +1,373 @@
1
# 包月充电
2
3
<img src="../../assets/img/battery-100.png" width="100" height="100"/>
4
5
## UP主包月充电详情
6
7
> https://api.bilibili.com/x/upower/item/detail
8
9
*请求方式：GET*
10
11
**url参数：**
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | ----------- | ------ | ---- |
15
| up_mid | num | 目标用户mid | 必要 | |
16
17
**json回复：**
18
19
根对象：
20
21
| 字段 | 类型 | 内容 | 备注 |
22
| ------- | ---- | -------- | --------------------------- |
23
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
24
| message | str | 错误信息 | 默认为0 |
25
| ttl | num | 1 | |
26
| data | obj | 信息本体 | |
27
28
`data`对象：
29
30
| 字段 | 类型 | 内容 | 备注 |
31
| ----------- | ---- | ---------- | ---- |
32
| upower_rank | obj | 充电详情 | |
33
| item | obj | 充电欢迎语 | |
34
| user_card | obj | UP主信息 | |
35
36
`data`中的`upower_rank`对象：
37
38
| 字段 | 类型 | 内容 | 备注 |
39
| ---------- | ----- | ---------------- | ------------ |
40
| total | num | 充电用户总数 | |
41
| total_desc | str | 充电总数文字说明 | 示例：“1+” |
42
| list | array | 充电用户列表 | 最多展示30个 |
43
44
`upower_rank`中的`list`数组：
45
46
| 项 | 类型 | 内容 | 备注 |
47
| ---- | ---- | --------- | ---------------- |
48
| 0 | obj | 用户1 | |
49
| n | obj | 用户(n+1) | |
50
| …… | obj | …… | …… |
51
52
数组`list`中的对象：
53
54
| 字段 | 类型 | 内容 | 备注 |
55
| -------- | ---- | --------------- | ---- |
56
| rank | num | 充电用户索引 | |
57
| mid | num | 充电用户mid | |
58
| nickname | str | 充电用户昵称 | |
59
| avatar | str | 充电用户头像url | |
60
61
`data`中的`item`对象：
62
63
| 字段 | 类型 | 内容 | 备注 |
64
| --------------- | ---- | ---------------- | ---- |
65
| intro_video_aid | str | 充电介绍视频AV号 | |
66
| welcomes | str | 充电介绍语 | |
67
68
`data`中的`user_card`对象：
69
70
| 字段 | 类型 | 内容 | 备注 |
71
| -------- | ---- | ----------- | ---- |
72
| avatar | str | UP主头像url | |
73
| nickname | str | UP主昵称 | |
74
75
**示例：**
76
77
获取`mid=293793435`的包月充电详情
78
79
80
```shell
81
curl 'https://api.bilibili.com/x/upower/item/detail' \
82
--data-urlencode 'up_mid=293793435' \
83
-b 'SESSDATA=xxx'
84
```
85
86
<details>
87
<summary>查看响应示例：</summary>
88
89
```json
90
{
91
"code": 0,
92
"message": "0",
93
"ttl": 1,
94
"data": {
95
"upower_rank": {
96
"total": 1,
97
"total_desc": "1+",
98
"list": [
99
{
100
"rank": 1,
101
"mid": 425503913,
102
"nickname": "wuziqian211",
103
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png"
104
}
105
]
106
},
107
"item": {
108
"intro_video_aid": "",
109
"welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ"
110
},
111
"user_card": {
112
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
113
"nickname": "社会易姐QwQ"
114
}
115
}
116
}
117
```
118
119
</details>
120
121
## 与UP主的包月充电关系
122
123
> https://api.bilibili.com/x/upower/charge/follow/info
124
125
*请求方式：GET*
126
127
认证方式：Cookie(SESSDATA)或APP
128
129
**url参数：**
130
131
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
132
| ------ | ---- | ----------- | ------ | ---- |
133
| up_mid | num | 目标用户mid | 必要 | |
134
135
**json回复：**
136
137
根对象：
138
139
| 字段 | 类型 | 内容 | 备注 |
140
| ------- | ---- | -------- | ------------------------------------------------- |
141
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
142
| message | str | 错误信息 | 默认为0 |
143
| ttl | num | 1 | |
144
| data | obj | 信息本体 | |
145
146
`data`对象：
147
148
| 字段 | 类型 | 内容 | 备注 |
149
| ---------------- | ---- | ------------------------ | ------------------------------------------- |
150
| days | num | 已保持多少天包月充电状态 | |
151
| up_card | obj | UP主信息 | |
152
| user_card | obj | 自己的信息 | |
153
| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 |
154
| remain_less_1day | num | 剩余的天数小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 |
155
| upower_rank | obj | 充电详情 | |
156
| upower_icon | str | 充电图标url | |
157
158
`data`中的`up_card`对象：
159
160
| 字段 | 类型 | 内容 | 备注 |
161
| -------------- | ---- | ------------ | ---- |
162
| nickname | str | UP主昵称 | |
163
| official_title | str | UP主认证信息 | |
164
| avatar | str | UP主头像url | |
165
166
`data`中的`user_card`对象：
167
168
| 字段 | 类型 | 内容 | 备注 |
169
| -------- | ---- | ----------- | ---- |
170
| avatar | str | 用户头像url | |
171
| nickname | str | 用户昵称 | |
172
173
`data`中的`upower_rank`对象：
174
175
| 字段 | 类型 | 内容 | 备注 |
176
| ---------- | ----- | ---------------- | ----------- |
177
| total | num | 充电用户总数 | |
178
| total_desc | str | 充电总数文字说明 | 示例：“1+” |
179
| list | array | 充电用户列表 | 最多展示6个 |
180
181
`upower_rank`中的`list`数组：
182
183
| 项 | 类型 | 内容 | 备注 |
184
| ---- | ---- | --------- | ---------------- |
185
| 0 | obj | 用户1 | |
186
| n | obj | 用户(n+1) | |
187
| …… | obj | …… | …… |
188
189
数组`list`中的对象：
190
191
| 字段 | 类型 | 内容 | 备注 |
192
| -------- | ---- | --------------- | ---- |
193
| rank | num | 充电用户索引 | |
194
| mid | num | 充电用户mid | |
195
| nickname | str | 充电用户昵称 | |
196
| avatar | str | 充电用户头像url | |
197
198
**示例：**
199
200
获取与`mid=293793435`的包月充电关系
201
202
203
```shell
204
curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
205
--data-urlencode 'up_mid=293793435' \
206
-b 'SESSDATA=xxx'
207
```
208
209
<details>
210
<summary>查看响应示例：</summary>
211
212
```json
213
{
214
"code": 0,
215
"message": "0",
216
"ttl": 1,
217
"data": {
218
"days": 17,
219
"up_card": {
220
"nickname": "社会易姐QwQ",
221
"official_title": "",
222
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
223
},
224
"user_card": {
225
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
226
"nickname": "wuziqian211"
227
},
228
"remain_days": 15,
229
"remain_less_1day": 0,
230
"upower_rank": {
231
"total": 1,
232
"total_desc": "1+",
233
"list": [
234
{
235
"rank": 1,
236
"mid": 425503913,
237
"nickname": "wuziqian211",
238
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png"
239
}
240
]
241
},
242
"upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png"
243
}
244
}
245
```
246
247
</details>
248
249
## 包月充电用户排名
250
251
> https://api.bilibili.com/x/upower/up/member/rank/v2
252
253
*请求方式：GET*
254
255
**url参数：**
256
257
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
258
| ------ | ---- | ----------- | ------ | -------- |
259
| up_mid | num | 目标用户mid | 必要 | |
260
| ps | num | 每页项数 | 非必要 | 默认为20 |
261
| pn | num | 页码 | 非必要 | 默认为1 |
262
263
**json回复：**
264
265
根对象：
266
267
| 字段 | 类型 | 内容 | 备注 |
268
| ------- | ---- | -------- | --------------------------- |
269
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
270
| message | str | 错误信息 | 默认为0 |
271
| ttl | num | 1 | |
272
| data | obj | 信息本体 | |
273
274
`data`对象：
275
276
| 字段 | 类型 | 内容 | 备注 |
277
| ------------ | ---- | ------------ | ---- |
278
| up_info | obj | UP主信息 | |
279
| rank_info | obj | 充电用户排名 | |
280
| user_info | obj | 自己的信息 | |
281
| member_total | str | 充电用户总数 | |
282
283
`data`中的`up_info`对象：
284
285
| 字段 | 类型 | 内容 | 备注 |
286
| -------- | ---- | ------------ | ---------------------------------------- |
287
| mid | num | UP主mid | |
288
| nickname | str | UP主昵称 | |
289
| avatar | str | UP主头像url | |
290
| type | num | UP主认证类型 | -1：无<br />0：UP主认证<br />1：机构认证 |
291
| title | str | UP主认证信息 | |
292
293
`data`中的`rank_info`数组：
294
295
| 项 | 类型 | 内容 | 备注 |
296
| ---- | ---- | --------- | ---------------- |
297
| 0 | obj | 用户1 | |
298
| n | obj | 用户(n+1) | 按照充电排名排列 |
299
| …… | obj | …… | …… |
300
301
数组`rank_info`中的对象：
302
303
| 字段 | 类型 | 内容 | 备注 |
304
| --------- | ---- | ---------------- | ----- |
305
| mid | num | 充电用户mid | |
306
| nickname | str | 充电用户昵称 | |
307
| avatar | str | 充电用户头像url | |
308
| rank | num | 充电用户排名 | |
309
| day | num | 包月充电天数 | |
310
| expire_at | num | 包月充电过期时间 | 恒为0 |
311
312
`data`中的`user_info`对象：
313
314
| 字段 | 类型 | 内容 | 备注 |
315
| --------- | ---- | ---------------- | ------------------------------- |
316
| mid | num | 用户mid | |
317
| nickname | str | 用户昵称 | |
318
| avatar | str | 用户头像url | |
319
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
320
| day | num | 包月充电天数 | |
321
| expire_at | num | 包月充电过期时间 | 单位为秒，未处于包月充电状态为0 |
322
323
**示例：**
324
325
获取给`mid=293793435`包月充电的用户排名
326
327
328
```shell
329
curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
330
--data-urlencode 'up_mid=293793435' \
331
-b 'SESSDATA=xxx'
332
```
333
334
<details>
335
<summary>查看响应示例：</summary>
336
337
```json
338
{
339
"code": 0,
340
"message": "0",
341
"ttl": 1,
342
"data": {
343
"up_info": {
344
"mid": 293793435,
345
"nickname": "社会易姐QwQ",
346
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
347
"type": -1,
348
"title": ""
349
},
350
"rank_info": [
351
{
352
"mid": 425503913,
353
"nickname": "wuziqian211",
354
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
355
"rank": 1,
356
"day": 31,
357
"expire_at": 0
358
}
359
],
360
"user_info": {
361
"mid": 425503913,
362
"nickname": "wuziqian211",
363
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
364
"rank": 1,
365
"day": 31,
366
"expire_at": 1678723199
367
},
368
"member_total": 1
369
}
370
}
371
```
372
373
</details>