返回提交历史
Modified
README.md
+3
-2
Modified
docs/electric/charge_list.md
+67
-65
Modified
docs/electric/charge_msg.md
+2
-2
Added
docs/electric/monthly.md
+373
-0
Modified
docs/user/relation.md
+104
-19
XFEstudio/bilibili-API-collect
新增包月充电功能相关API (#626)
* Update charge_list.md * Update charge_msg.md * Update relation.md * Update relation.md * update * Update monthly.md * Update monthly.md * update
490d4c5
代码差异
5 个文件
+549
-88
@@ -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)
@@ -2,7 +2,7 @@
2
2
3
3
## 获取空间充电公示列表
4
4
5
> https://elec.bilibili.com/api/query.rank.do
5
> https://api.bilibili.com/x/ugcpay-rank/elec/month/up
6
6
7
7
*请求方式:GET*
8
8
@@ -10,27 +10,28 @@
10
10
11
11
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
12
| ------ | ---- | ----------- | ------ | ---- |
13
| mid | num | 目标用户mid | 必要 | |
13
| up_mid | num | 目标用户mid | 必要 | |
14
14
15
15
**json回复：**
16
16
17
17
根对象：
18
18
19
| 字段 | 类型 | 内容 | 备注 |
20
| ---- | ---- | -------- | ----------------------------- |
21
| code | num | 返回值 | 0：成功 <br />500011：mid错误 |
22
| msg | str | 错误信息 | 正确时无此项 |
23
| data | obj | 数据本体 | |
19
| 字段 | 类型 | 内容 | 备注 |
20
| ------- | ---- | -------- | ---------------------------- |
21
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
22
| message | str | 错误信息 | |
23
| ttl | num | 0 | |
24
| data | obj | 数据本体 | |
24
25
25
26
`data`对象：
26
27
27
| 字段 | 类型 | 内容 | 备注 |
28
| ----------- | ------ | ---------------- | ------------ |
29
| display_num | num | 0 | 作用尚不明确 |
30
| count | num | 本月充电人数 | |
31
| total_count | num | 总计充电人数 | |
28
| 字段 | 类型 | 内容 | 备注 |
29
| ----------- | ----- | ---------------- | ------------ |
30
| count | num | 本月充电人数 | |
32
31
| list | array | 本月充电用户列表 | |
33
| user | null | | 作用尚不明确 |
32
| total_count | num | 总计充电次数 | |
33
| total | num | 总计充电次数 | 同上 |
34
| special_day | num | 0 | 作用尚不明确 |
34
35
35
36
`data`中的`list`数组：
36
37
@@ -43,32 +44,32 @@
43
44
44
45
`data`中的`list`数组中的对象：
45
46
46
| 字段 | 类型 | 内容 | 备注 |
47
| ----------- | ---- | ---------------- | ---------------- |
48
| mid | num | 充电对象mid | |
49
| pay_mid | num | 充电用户mid | |
50
| rank | num | 充电用户排名 | 取决于充电的多少 |
51
| uname | str | 充电用户昵称 | |
52
| avatar | str | 充电用户头像url | |
53
| message | str | 充电留言 | 无为空 |
54
| msg_deleted | num | 0 | 作用尚不明确 |
55
| vip_info | obj | 充电用户会员信息 | |
56
| trend_type | num | 0 | 作用尚不明确 |
57
58
`data`中的`list`数组中的对象中的`vip_info`对象：
59
60
| 字段 | 类型 | 内容 | 备注 |
61
| ---------- | ---- | ---------- | ----------------------------------- |
62
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
63
| vipDueMsec | num | 0 | 作用尚不明确 |
64
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
47
| 字段 | 类型 | 内容 | 备注 |
48
| ---------- | ---- | ---------------- | ---------------- |
49
| uname | str | 充电用户昵称 | |
50
| avatar | str | 充电用户头像url | |
51
| mid | num | 充电对象mid | |
52
| pay_mid | num | 充电用户mid | |
53
| rank | num | 充电用户排名 | 取决于充电的多少 |
54
| trend_type | num | 0 | 作用尚不明确 |
55
| vip_info | obj | 充电用户会员信息 | |
56
| message | str | 充电留言 | 无为空 |
57
| msg_hidden | num | 0 | 作用尚不明确 |
58
59
`list`数组中的对象中的`vip_info`对象：
60
61
| 字段 | 类型 | 内容 | 备注 |
62
| ---------- | ---- | -------------------- | ----------------------------------------- |
63
| vipDueMsec | num | 大会员过期时间（？） | 恒为0 |
64
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
65
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员及以上 |
65
66
66
67
**示例：**
67
68
68
69
查询用户`mid=53456`的充电公示列表
69
70
70
71
```shell
71
curl -G 'https://elec.bilibili.com/api/query.rank.do' \
72
curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up?up_mid=53456' \
72
73
--data-urlencode 'mid=53456'
73
74
```
74
75
@@ -78,59 +79,60 @@ curl -G 'https://elec.bilibili.com/api/query.rank.do' \
78
79
```json
79
80
{
80
81
"code": 0,
82
"message": "",
83
"ttl": 0,
81
84
"data": {
82
"display_num": 0,
83
"count": 226,
84
"total_count": 11528,
85
"count": 397,
85
86
"list": [
86
87
{
88
"uname": "Mars韩笑",
89
"avatar": "https://i1.hdslb.com/bfs/face/a46599fa41cac672eda677e334f0be93cca02f1f.jpg",
87
90
"mid": 53456,
88
"pay_mid": 346545025,
91
"pay_mid": 5683462,
89
92
"rank": 1,
90
"uname": "还有什么名字没人用",
91
"avatar": "http://i1.hdslb.com/bfs/face/76d4b1ecd13e992a6c7303d77bf716dd922ab234.jpg",
92
"message": "早日康复，五月快乐",
93
"msg_deleted": 0,
93
"trend_type": 0,
94
94
"vip_info": {
95
"vipType": 2,
96
95
"vipDueMsec": 0,
97
"vipStatus": 1
96
"vipStatus": 1,
97
"vipType": 2
98
98
},
99
"trend_type": 0
99
"message": "你真棒，你是奇迹！（Warma真的是太棒了！",
100
"message_hidden": 0
100
101
},
101
102
{
103
"uname": "愚星-",
104
"avatar": "https://i1.hdslb.com/bfs/face/7e4a8b150567a20a1b075aa3894dd3674a1e6ebe.jpg",
102
105
"mid": 53456,
103
"pay_mid": 8826056,
106
"pay_mid": 382630072,
104
107
"rank": 2,
105
"uname": "煋痕",
106
"avatar": "http://i2.hdslb.com/bfs/face/35b7c752d0eb1bb7a924804f240b9bfd9199625f.jpg",
107
"message": "",
108
"msg_deleted": 0,
108
"trend_type": 0,
109
109
"vip_info": {
110
"vipType": 2,
111
110
"vipDueMsec": 0,
112
"vipStatus": 1
111
"vipStatus": 1,
112
"vipType": 1
113
113
},
114
"trend_type": 0
114
"message": "感谢您给我带来的快乐！我的人生遇见你是我的荣幸！！",
115
"message_hidden": 0
115
116
},
116
117
{
118
"uname": "なか酱",
119
"avatar": "https://i0.hdslb.com/bfs/face/d4b74091d7f1c336399625dc062ddc93d676bcdc.jpg",
117
120
"mid": 53456,
118
"pay_mid": 356668487,
121
"pay_mid": 446080731,
119
122
"rank": 3,
120
"uname": "舞象祥",
121
"avatar": "http://i1.hdslb.com/bfs/face/574f6203ef5bd0d56b95ded6a2736676d9cc5307.jpg",
122
"message": "warma hayo",
123
"msg_deleted": 0,
123
"trend_type": 0,
124
124
"vip_info": {
125
"vipType": 1,
126
125
"vipDueMsec": 0,
127
"vipStatus": 1
126
"vipStatus": 1,
127
"vipType": 2
128
128
},
129
"trend_type": 0
130
},
131
…………
129
"message": "",
130
"message_hidden": 0
131
}
132
132
],
133
"user": null
133
"total_count": 27291,
134
"total": 27291,
135
"special_day": 0
134
136
}
135
137
}
136
138
```
@@ -434,8 +436,8 @@ curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRec
434
436
435
437
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
436
438
| -------- | ---- | -------- | ------ | -------------------------------- |
437
| pn | num | 页数 | 必要 | |
438
| ps | num | 分页大小 | 必要 | 取值范围[1,20] |
439
| pn | num | 页数 | 非必要 | |
440
| ps | num | 分页大小 | 非必要 | 取值范围[1,20] |
439
441
440
442
**json回复：**
441
443
@@ -164,7 +164,7 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01
164
164
165
165
## 查询充电留言详情
166
166
167
> https://member.bilibili.com/x/web/elec/remark/detail?id=6662619
167
> https://member.bilibili.com/x/web/elec/remark/detail
168
168
169
169
认证方式：Cookie（SESSDATA）
170
170
@@ -293,4 +293,4 @@ curl -L -X POST 'https://member.bilibili.com/x/web/elec/remark/reply' \
293
293
}
294
294
```
295
295
296
</details>
296
</details>
@@ -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：请求错误<br />203101：UP主未开通包月充电功能 |
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 | array | 充电用户排名 | |
280
| user_info | obj | 自己的信息 | |
281
| member_total | num | 充电用户总数 | |
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 | 包月充电过期时间 | 单位为秒，若从未给UP主包月充电为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>
@@ -202,7 +202,7 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
202
202
| ttl | num | 1 | |
203
203
| data | obj | 信息本体 | |
204
204
205
data 对象：
205
`data`对象：
206
206
207
207
| 字段 | 类型 | 内容 | 备注 |
208
208
| ---------- | ----- | -------- | ------------ |
@@ -356,32 +356,28 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
356
356
357
357
*请求方式：GET*
358
358
359
认证方式：Cookie(SESSDATA)或APP
360
361
登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
359
仅可查看前5页，可以获取已设置可见性隐私的关注列表
362
360
363
361
**url参数：**
364
362
365
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
366
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
367
| access_key | str | APP登录Token | APP方式必要 | |
368
| vmid | num | 目标用户mid | 必要 | |
369
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
370
| ps | num | 每页项数 | 非必要 | 默认为50 |
371
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
363
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
364
| ---------- | ---- | ------------ | ------ | -------------------------- |
365
| vmid | num | 目标用户mid | 必要 | |
366
| ps | num | 每页项数 | 非必要 | 默认为50 |
367
| pn | num | 页码 | 非必要 | 默认为1<br />仅可查看前5页 |
372
368
373
369
**json回复：**
374
370
375
371
根对象：
376
372
377
| 字段 | 类型 | 内容 | 备注 |
378
| ------- | ---- | -------- | ------------------------------------------------------------ |
373
| 字段 | 类型 | 内容 | 备注 |
374
| ------- | ---- | -------- | --------------------------------------------------- |
379
375
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
380
| message | str | 错误信息 | 默认为0 |
381
| ttl | num | 1 | |
382
| data | obj | 信息本体 | |
376
| message | str | 错误信息 | 默认为0 |
377
| ttl | num | 1 | |
378
| data | obj | 信息本体 | |
383
379
384
data 对象：
380
`data`对象：
385
381
386
382
| 字段 | 类型 | 内容 | 备注 |
387
383
| ---------- | ----- | -------- | ------------ |
@@ -453,10 +449,8 @@ data 对象：
453
449
```shell
454
450
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
455
451
--data-urlencode 'vmid=293793435' \
456
452
--data-urlencode 'ps=2' \
457
453
--data-urlencode 'pn=1' \
458
-b 'SESSDATA=xxx'
459
454
```
460
455
461
456
<details>
@@ -527,6 +521,97 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
527
521
528
522
</details>
529
523
524
## 查询用户关注明细3
525
526
<img src="../../assets/img/relation.svg" width="100" height="100" />
527
528
> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
529
530
*请求方式：GET*
531
532
可获取用户所有关注列表，对于设置了可见性隐私的用户会返回空列表
533
534
**url参数：**
535
536
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
537
| ------ | ---- | ------------ | ----------- | -------- |
538
| vmid | num | 目标用户mid | 必要 | |
539
| ps | num | 每页项数 | 非必要 | 默认为20 |
540
| pn | num | 页码 | 非必要 | 默认为1 |
541
542
**json回复：**
543
544
根对象：
545
546
| 字段 | 类型 | 内容 | 备注 |
547
| ---------- | ---- | ---------- | --------------------------- |
548
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
549
| message | str | 错误信息 | 成功时无此项 |
550
| data | obj | 信息本体 | 失败时无此项 |
551
| ts | num | 当前时间戳 | 单位为毫秒 |
552
| request_id | str | 请求id | |
553
554
`data`对象：
555
556
| 字段 | 类型 | 内容 | 备注 |
557
| ---------- | ----- | -------- | ------------ |
558
| list | array | 明细列表 | |
559
560
`data`中的`list`数组：
561
562
| 项 | 类型 | 内容 | 备注 |
563
| ---- | ---- | --------- | ---------------- |
564
| 0 | obj | 关注1 | |
565
| n | obj | 关注(n+1) | 按照关注顺序排列 |
566
| …… | obj | …… | …… |
567
568
数组`list`中的对象：
569
570
| 字段 | 类型 | 内容 | 备注 |
571
| --------------- | ---- | ----------- | --------------------------------------- |
572
| mid | str | 用户mid | |
573
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
574
| uname | str | 用户昵称 | |
575
| face | str | 用户头像url | |
576
577
**示例：**
578
579
获取用户`mid=293793435`的关注明细
580
581
```shell
582
curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \
583
--data-urlencode 'vmid=293793435' \
584
--data-urlencode 'ps=2' \
585
--data-urlencode 'pn=1' \
586
-b 'SESSDATA=xxx'
587
```
588
589
<details>
590
<summary>查看响应示例：</summary>
591
592
```json
593
{
594
"code": 0,
595
"data": {
596
"list": [{
597
"mid": "14082",
598
"attribute": 2,
599
"uname": "山新",
600
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg"
601
}, {
602
"mid": "420831218",
603
"attribute": 2,
604
"uname": "支付宝Alipay",
605
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg"
606
}]
607
},
608
"ts": 1677410818395,
609
"request_id": "d9d541b9f2d24e21821e2d6d2d16c17d"
610
}
611
```
612
613
</details>
614
530
615
## 搜索关注明细
531
616
532
617
<img src="../../assets/img/relation.svg" width="100" height="100" />