返回提交历史
Modified
docs/electric/monthly.md
+201
-19
XFEstudio/bilibili-API-collect
Update monthly.md
c7400ff
代码差异
1 个文件
+201
-19
@@ -2,6 +2,180 @@
2
2
3
3
<img src="../../assets/img/battery-100.png" width="100" height="100"/>
4
4
5
## 获取包月充电列表
6
7
> https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord
8
9
*请求方式：GET*
10
11
认证方式：Cookie(SESSDATA)或APP
12
13
**url参数：**
14
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
16
| ------ | ---- | -------- | ------ | ------------------------ |
17
| page | num | 页码 | 必要 | |
18
| type | num | 充电状态 | 必要 | 1：使用中<br />2：已过期 |
19
20
**json回复：**
21
22
根对象：
23
24
| 字段 | 类型 | 内容 | 备注 |
25
| ------- | ---- | -------- | ------------------------------------------------------------------------- |
26
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />25100004：参数错误 |
27
| message | str | 错误信息 | 默认为0 |
28
| ttl | num | 1 | |
29
| data | obj | 信息本体 | |
30
31
`data`对象：
32
33
| 字段 | 类型 | 内容 | 备注 |
34
| ---------- | ----- | ---------------- | ---------------- |
35
| list | 有内容时：array<br />无内容时：null | 包月充电UP主列表 | 最多10个 |
36
| page | num | 当前页数 | |
37
| page_size | num | 当前分页大小 | 一般为10 |
38
| total_page | num | 总页数 | |
39
| total_num | num | 用户总数 | |
40
| is_more | num | 是否有更多用户 | 0：否<br />1：是 |
41
42
`data`中的`list`数组：
43
44
| 项 | 类型 | 内容 | 备注 |
45
| ---- | ---- | --------- | ---------------- |
46
| 0 | obj | 用户1 | |
47
| n | obj | 用户(n+1) | |
48
| …… | obj | …… | …… |
49
50
数组`list`中的对象：
51
52
| 字段 | 类型 | 内容 | 备注 |
53
| --------- | ----- | --------------- | ------ |
54
| up_uid | num | 充电UP主mid | |
55
| user_name | str | 充电UP主昵称 | |
56
| user_face | str | 充电UP主头像url | |
57
| item | array | 充电详情 | |
58
| start | num | 开始充电时间 | 时间戳 |
59
60
数组`list`中的对象中的`item`数组：
61
62
| 项 | 类型 | 内容 | 备注 |
63
| ---- | ---- | -------- | -------- |
64
| 0 | obj | 充电详情 | 套了个娃 |
65
66
数组`item`中的对象：
67
68
| 字段 | 类型 | 内容 | 备注 |
69
| -------------- | --------------------------------------------- | ---------------- | ---------------- |
70
| privilege_type | num | 10（？） | **作用尚不明确** |
71
| icon | str | 充电图标 | |
72
| name | str | `包月充电` | |
73
| expire_time | num | 充电过期时间 | 时间戳 |
74
| renew | 开启自动续费时：obj<br />关闭自动续费时：null | 充电自动续费详情 | |
75
76
数组`item`中的对象中的`renew`对象：
77
78
| 字段 | 类型 | 内容 | 备注 |
79
| ----------------- | ---- | ------------ | ------------------------------------------------- |
80
| uid | num | 自己的mid | |
81
| ruid | num | UP主的mid | |
82
| goods_id | num | 充电类型 | 172：一个月<br />173：连续包月<br />174：连续包年 |
83
| status | num | 充电状态 | 1 |
84
| next_execute_time | num | 下次续费时间 | 时间戳 |
85
| signed_time | num | 签约时间 | 时间戳 |
86
| signed_price | num | 下次续费金额 | 单位为千分之一元人民币 |
87
| pay_channel | num | 签约平台 | 2：微信支付<br />4：支付宝 |
88
| period | num | 下次充电天数 | |
89
90
**示例：**
91
92
获取自己正在使用的包月充电的列表
93
94
95
```shell
96
curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
97
--data-urlencode 'page=1' \
98
--data-urlencode 'type=1' \
99
-b 'SESSDATA=xxx'
100
```
101
102
<details>
103
<summary>查看响应示例：</summary>
104
105
```json
106
{
107
"code": 0,
108
"message": "0",
109
"ttl": 1,
110
"data": {
111
"list": [
112
{
113
"up_uid": 2233,
114
"user_name": "2233",
115
"user_face": "https://i0.hdslb.com/bfs/face/noface.jpg",
116
"item": [
117
{
118
"privilege_type": 10,
119
"icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png",
120
"name": "包月充电",
121
"expire_time": 1703519999,
122
"renew": {
123
"uid": 425503913,
124
"ruid": 2233,
125
"goods_id": 174,
126
"status": 1,
127
"next_execute_time": 1703174400,
128
"signed_time": 1671618921,
129
"signed_price": 36000,
130
"pay_channel": 2,
131
"period": 366
132
}
133
}
134
],
135
"start": 1669183804
136
},
137
{
138
"up_uid": 293793435,
139
"user_name": "社会易姐QwQ",
140
"user_face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
141
"item": [
142
{
143
"privilege_type": 10,
144
"icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png",
145
"name": "包月充电",
146
"expire_time": 1681401599,
147
"renew": {
148
"uid": 425503913,
149
"ruid": 293793435,
150
"goods_id": 173,
151
"status": 1,
152
"next_execute_time": 1680364800,
153
"signed_time": 1677760921,
154
"signed_price": 5000,
155
"pay_channel": 4,
156
"period": 31
157
}
158
}
159
],
160
"start": 1676033795
161
}
162
],
163
"page": 1,
164
"page_size": 10,
165
"total_page": 3,
166
"total_num": 22,
167
"is_more": 1
168
}
169
}
170
```
171
172
173
</details>
174
175
表示自己从2022-11-23 14:10:04开始给“2233”包月充电，并且在2022-12-21 18:35:21在微信开通了连续包年充电，在2023-12-22 00:00:00的时候会自动续费36元，并继续充电366天；
176
177
自己从2023-02-10 20:56:35开始给“社会易姐QwQ”包月充电，并且在2023-03-02 20:42:01在支付宝开通了连续包月充电，在2023-04-02 00:00:00的时候会自动续费5元，并继续充电31天。
178
5
179
## UP主包月充电详情
6
180
7
181
> https://api.bilibili.com/x/upower/item/detail
@@ -153,7 +327,7 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
153
327
| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 |
154
328
| remain_less_1day | num | 剩余的天数小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 |
155
329
| upower_rank | obj | 充电详情 | |
156
| upower_icon | str | 充电图标url | |
330
| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 |
157
331
158
332
`data`中的`up_card`对象：
159
333
@@ -246,12 +420,16 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
246
420
247
421
</details>
248
422
423
表示自己已保持17天对“社会易姐QwQ”的包月充电，剩余15天过期。
424
249
425
## 包月充电用户排名
250
426
251
427
> https://api.bilibili.com/x/upower/up/member/rank/v2
252
428
253
429
*请求方式：GET*
254
430
431
认证方式：Cookie(SESSDATA)或APP
432
255
433
**url参数：**
256
434
257
435
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -300,25 +478,27 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
300
478
301
479
数组`rank_info`中的对象：
302
480
303
| 字段 | 类型 | 内容 | 备注 |
304
| --------- | ---- | ---------------- | ----- |
305
| mid | num | 充电用户mid | |
306
| nickname | str | 充电用户昵称 | |
307
| avatar | str | 充电用户头像url | |
308
| rank | num | 充电用户排名 | |
309
| day | num | 包月充电天数 | |
310
| expire_at | num | 包月充电过期时间 | 恒为0 |
481
| 字段 | 类型 | 内容 | 备注 |
482
| ----------- | ---- | ---------------- | ----- |
483
| mid | num | 充电用户mid | |
484
| nickname | str | 充电用户昵称 | |
485
| avatar | str | 充电用户头像url | |
486
| rank | num | 充电用户排名 | |
487
| day | num | 包月充电天数 | |
488
| expire_at | num | 包月充电过期时间 | 恒为0 |
489
| remain_days | num | 剩余天数 | 恒为0 |
311
490
312
491
`data`中的`user_info`对象：
313
492
314
| 字段 | 类型 | 内容 | 备注 |
315
| --------- | ---- | ---------------- | --------------------------------- |
316
| mid | num | 用户mid | |
317
| nickname | str | 用户昵称 | |
318
| avatar | str | 用户头像url | |
319
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
320
| day | num | 包月充电天数 | |
321
| expire_at | num | 包月充电过期时间 | 单位为秒，若从未给UP主包月充电为0 |
493
| 字段 | 类型 | 内容 | 备注 |
494
| ----------- | ---- | ---------------- | ------------------------------- |
495
| mid | num | 用户mid | |
496
| nickname | str | 用户昵称 | |
497
| avatar | str | 用户头像url | |
498
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
499
| day | num | 包月充电天数 | |
500
| expire_at | num | 包月充电过期时间 | 时间戳，若从未给UP主包月充电为0 |
501
| remain_days | num | 未过期时：剩余天数<br />已过期且之前给UP主包月充电过：自过期以来的天数 | |
322
502
323
503
**示例：**
324
504
@@ -354,7 +534,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
354
534
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
355
535
"rank": 1,
356
536
"day": 31,
357
"expire_at": 0
537
"expire_at": 0，
538
"remain_days": 0
358
539
}
359
540
],
360
541
"user_info": {
@@ -363,7 +544,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
363
544
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
364
545
"rank": 1,
365
546
"day": 31,
366
"expire_at": 1678723199
547
"expire_at": 1678723199,
548
"remain_days": 15
367
549
},
368
550
"member_total": 1
369
551
}