返回提交历史
Modified
live/info.md
+2
-2
Modified
login/login_info.md
+48
-48
Modified
user/info.md
+171
-123
Modified
user/relation.md
+372
-54
Modified
user/space.md
+113
-90
XFEstudio/bilibili-API-collect
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
3d66604
代码差异
5 个文件
+706
-317
@@ -37,8 +37,8 @@
37
37
| liveStatus | num | 直播状态 | 0：未开播<br />1：直播中 |
38
38
| url | str | 直播间网页url | |
39
39
| title | str | 直播间标题 | |
40
| cover | str | 直播间封面 | |
41
| online | num | 直播间人气 | 值为上次直播刷新 |
40
| cover | str | 直播间封面url | |
41
| online | num | 直播间人气 | 值为上次直播时刷新 |
42
42
| roomid | num | 直播间ID（短号） | |
43
43
| broadcast_type | num | 0 | |
44
44
| online_hidden | num | 0 | |
@@ -1,6 +1,6 @@
1
1
# 登录基本信息
2
2
3
- [登录用户信息1（web端）](#登录用户信息1（web端）)
3
- [导航栏用户信息](#导航栏用户信息)
4
4
- [登录用户信息2（web端）（仅部分）](#登录用户信息2（web端）（仅部分）)
5
5
- [登录用户信息（APP端）](#登录用户信息（APP端）)
6
6
- [登录用户状态数（双端）](#登录用户状态数（双端）)
@@ -8,7 +8,7 @@
8
8
9
9
---
10
10
11
## 登录用户信息1（web端）
11
## 导航栏用户信息
12
12
13
13
> http://api.bilibili.com/nav（带有转义）
14
14
>
@@ -31,34 +31,34 @@
31
31
32
32
`data`对象：
33
33
34
| 字段 | 类型 | 内容 | 备注 |
35
| -------------------- | ---- | ---------------- | ------------------------------- |
36
| isLogin | bool | 是否已登录 | false：未登录<br />true：已登录 |
37
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
38
| face | str | 用户头像url | |
39
| level_info | obj | 等级信息 | |
40
| mid | num | 用户UID | |
41
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
42
| money | num | 拥有硬币数 | |
43
| moral | num | 当前节操值 | 上限70 |
44
| official | obj | 认证信息 | |
45
| officialVerify | obj | 认证信息2 | |
46
| pendant | obj | 头像框信息 | |
47
| scores | num | 0 | **作用尚不明确** |
48
| uname | str | 用户昵称 | |
49
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
50
| vipStatus | num | 会员开通状态 | 0：无<br />1：有 |
51
| vipType | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 |
52
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
53
| vip_theme_type | num | 0 | **作用尚不明确** |
54
| vip_label | obj | 大会员信息 | |
55
| vip_avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
56
| vip_nickname_color | str | 会员昵称颜色 | 颜色码 |
57
| wallet | obj | B币信息 | |
58
| has_shop | bool | false | **作用尚不明确** |
59
| shop_url | str | 空 | **作用尚不明确** |
60
| allowance_count | num | 0 | **作用尚不明确** |
61
| answer_status | num | 0 | **作用尚不明确** |
34
| 字段 | 类型 | 内容 | 备注 |
35
| -------------------- | ---- | ---------------- | ----------------------------------------------- |
36
| isLogin | bool | 是否已登录 | false：未登录<br />true：已登录 |
37
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
38
| face | str | 用户头像url | |
39
| level_info | obj | 等级信息 | |
40
| mid | num | 用户UID | |
41
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
42
| money | num | 拥有硬币数 | |
43
| moral | num | 当前节操值 | 上限为70 |
44
| official | obj | 认证信息 | |
45
| officialVerify | obj | 认证信息2 | |
46
| pendant | obj | 头像框信息 | |
47
| scores | num | 0 | 作用尚不明确 |
48
| uname | str | 用户昵称 | |
49
| vipDueDate | num | 会员到期时间 | 毫秒 时间戳 |
50
| vipStatus | num | 会员开通状态 | 0：无<br />1：有 |
51
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
52
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
53
| vip_theme_type | num | 0 | 作用尚不明确 |
54
| vip_label | obj | 会员标签 | |
55
| vip_avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
56
| vip_nickname_color | str | 会员昵称颜色 | 颜色码 |
57
| wallet | obj | B币钱包信息 | |
58
| has_shop | bool | 是否拥有推广商品 | false：无<br />true：有 |
59
| shop_url | str | 商品推广页面url | |
60
| allowance_count | num | 0 | 作用尚不明确 |
61
| answer_status | num | 0 | 作用尚不明确 |
62
62
63
63
`data`中的`level_info`对象：
64
64
@@ -87,29 +87,29 @@
87
87
88
88
`data`中的`pendant`对象：
89
89
90
| 字段 | 类型 | 内容 | 备注 |
91
| ------ | ---- | ----------- | ---------------- |
92
| pid | num | 挂件id | |
93
| name | str | 挂件名称 | |
94
| image | str | 挂件图片url | |
95
| expire | num | 0 | **作用尚不明确** |
90
| 字段 | 类型 | 内容 | 备注 |
91
| ------ | ---- | ----------- | ------------ |
92
| pid | num | 挂件id | |
93
| name | str | 挂件名称 | |
94
| image | str | 挂件图片url | |
95
| expire | num | 0 | 作用尚不明确 |
96
96
97
97
`data`中的`vip_label`对象：
98
98
99
| 字段 | 类型 | 内容 | 备注 |
100
| ----------- | ---- | ------------ | ---------------- |
101
| path | str | 空 | **作用尚不明确** |
102
| text | str | 会员类型文字 | |
103
| label_theme | str | 会员类型 | |
99
| 字段 | 类型 | 内容 | 备注 |
100
| ----------- | ---- | -------- | ------------------------------------------------------------ |
101
| path | str | 空 | 作用尚不明确 |
102
| text | str | 会员名称 | |
103
| label_theme | str | 会员标签 | vip：大会员<br />annual_vip：年度大会员<br />ten_annual_vip：十年大会员<br />hundred_annual_vip：百年大会员 |
104
104
105
105
`data`中的`wallet`对象：
106
106
107
| 字段 | 类型 | 内容 | 备注 |
108
| --------------- | ---- | ------------- | ---------------- |
109
| mid | num | 登录用户UID | |
110
| bcoin_balance | num | 拥有B币数 | |
111
| coupon_balance | num | 每月奖励B币数 | |
112
| coupon_due_time | num | 0 | **作用尚不明确** |
107
| 字段 | 类型 | 内容 | 备注 |
108
| --------------- | ---- | ------------- | ------------ |
109
| mid | num | 登录用户UID | |
110
| bcoin_balance | num | 拥有B币数 | |
111
| coupon_balance | num | 每月奖励B币数 | |
112
| coupon_due_time | num | 0 | 作用尚不明确 |
113
113
114
114
**示例：**
115
115
@@ -187,7 +187,7 @@ curl 'http://api.bilibili.com/nav' \
187
187
188
188
</details>
189
189
190
## 登录用户信息2（web端）（仅部分）
190
## 登录用户信息（仅部分）
191
191
192
192
> http://account.bilibili.com/home/userInfo
193
193
@@ -39,25 +39,26 @@
39
39
| ----------- | ---- | ---------------- | ------------------------------------------------------------ |
40
40
| mid | num | UID | |
41
41
| name | str | 昵称 | |
42
| sex | str | 性别 | 男 女 保密 |
42
| sex | str | 性别 | 男/女/保密 |
43
43
| face | str | 头像链接 | |
44
44
| sign | str | 签名 | |
45
| rank | num | 10000 | **作用尚不明确** |
45
| rank | num | 10000 | |
46
46
| level | num | 当前等级 | 0-6级 |
47
| jointime | num | 0 | **作用尚不明确** |
48
| moral | num | 0 | **作用尚不明确** |
47
| jointime | num | 0 | |
48
| moral | num | 0 | |
49
49
| silence | num | 封禁状态 | 0：正常<br />1：被封 |
50
| birthday | str | 生日 | MM-DD |
50
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
51
51
| coins | num | 硬币数 | 需要登录(Cookie) <br />只能查看自己的<br />默认为0 |
52
52
| fans_badge | bool | 是否具有粉丝勋章 | false：无<br />true：有 |
53
53
| official | obj | 认证信息 | |
54
| vip | obj | 大会员信息 | |
54
| vip | obj | 会员信息 | |
55
55
| pendant | obj | 头像框信息 | |
56
56
| nameplate | obj | 勋章信息 | |
57
57
| is_followed | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录恒为false |
58
58
| top_photo | str | 主页头图链接 | |
59
59
| theme | obj | 空 | **作用尚不明确** |
60
60
| sys_notice | obj | 系统通知 | 无内容则为空 |
61
| live_room | obj | 直播间信息 | |
61
62
62
63
`data`中的`official`对象：
63
64
@@ -70,11 +71,22 @@
70
71
71
72
`data`中的`vip`对象：
72
73
73
| 字段 | 类型 | 内容 | 备注 |
74
| ---------- | ---- | ---------- | ----------------------------------- |
75
| type | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
76
| status | num | 大会员状态 | 0：无<br />1：有 |
77
| theme_type | num | 0 | 作用尚不明确 |
74
| 字段 | 类型 | 内容 | 备注 |
75
| ---------------- | ---- | ---------------- | --------------------------------------------- |
76
| type | num | 会员类型 | 0：无<br />1：月大会员<br />2：年以上的大会员 |
77
| status | num | 会员状态 | 0：无<br />1：有 |
78
| theme_type | num | 0 | 作用尚不明确 |
79
| label | obj | 会员标签 | |
80
| avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
81
| nickname_color | str | 会员昵称颜色 | 颜色码 |
82
83
`vip`中的`label`对象：
84
85
| 字段 | 类型 | 内容 | 备注 |
86
| ----------- | ---- | -------- | ------------------------------------------------------------ |
87
| path | str | 空 | 作用尚不明确 |
88
| text | str | 会员名称 | |
89
| label_theme | str | 会员标签 | vip：大会员<br />annual_vip：年度大会员<br />ten_annual_vip：十年大会员<br />hundred_annual_vip：百年大会员 |
78
90
79
91
`data`中的`pendant`对象：
80
92
@@ -104,7 +116,21 @@
104
116
| content | str | 提示信息 | |
105
117
| url | str | 提示信息链接url | |
106
118
107
**示列：**
119
`data`中的`live_room`对象：
120
121
| 字段 | 类型 | 内容 | 备注 |
122
| -------------- | ---- | ---------------- | ------------------------ |
123
| roomStatus | num | 直播间状态 | 0：无房间<br />1：有房间 |
124
| liveStatus | num | 直播状态 | 0：未开播<br />1：直播中 |
125
| url | str | 直播间网页url | |
126
| title | str | 直播间标题 | |
127
| cover | str | 直播间封面url | |
128
| online | num | 直播间人气 | 值为上次直播时刷新 |
129
| roomid | num | 直播间ID（短号） | |
130
| roundStatus | num | 轮播状态 | 0：未轮播<br />1：轮播 |
131
| broadcast_type | num | 0 | |
132
133
**示例：**
108
134
109
135
查询用户`UID=2`的详细信息
110
136
@@ -119,53 +145,72 @@ curl -G 'http://api.bilibili.com/x/space/acc/info' \
119
145
120
146
```json
121
147
{
122
"code": 0,
123
"message": "0",
124
"ttl": 1,
125
"data": {
126
"mid": 2,
127
"name": "碧诗",
128
"sex": "男",
129
"face": "http://i0.hdslb.com/bfs/app/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg",
130
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
131
"rank": 20000,
132
"level": 6,
133
"jointime": 0,
134
"moral": 0,
135
"silence": 0,
136
"birthday": "09-19",
137
"coins": 0,
138
"fans_badge": true,
139
"official": {
140
"role": 2,
141
"title": "bilibili创始人（站长）",
142
"desc": "",
143
"type": 0
144
},
145
"vip": {
146
"type": 2,
147
"status": 1,
148
"theme_type": 0
149
},
150
"pendant": {
151
"pid": 76,
152
"name": "管理员",
153
"image": "http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png",
154
"expire": 0
155
},
156
"nameplate": {
157
"nid": 10,
158
"name": "见习偶像",
159
"image": "http://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
160
"image_small": "http://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
161
"level": "普通勋章",
162
"condition": "所有自制视频总播放数\u003e=10万"
163
},
164
"is_followed": true,
165
"top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
166
"theme": {},
167
"sys_notice": {}
168
}
148
"code": 0,
149
"message": "0",
150
"ttl": 1,
151
"data": {
152
"mid": 2,
153
"name": "碧诗",
154
"sex": "男",
155
"face": "http://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
156
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
157
"rank": 20000,
158
"level": 6,
159
"jointime": 0,
160
"moral": 0,
161
"silence": 0,
162
"birthday": "09-19",
163
"coins": 0,
164
"fans_badge": true,
165
"official": {
166
"role": 2,
167
"title": "bilibili创始人（站长）",
168
"desc": "",
169
"type": 0
170
},
171
"vip": {
172
"type": 2,
173
"status": 1,
174
"theme_type": 0,
175
"label": {
176
"path": "",
177
"text": "十年大会员",
178
"label_theme": "ten_annual_vip"
179
},
180
"avatar_subscript": 1,
181
"nickname_color": "#FB7299"
182
},
183
"pendant": {
184
"pid": 0,
185
"name": "",
186
"image": "",
187
"expire": 0,
188
"image_enhance": ""
189
},
190
"nameplate": {
191
"nid": 10,
192
"name": "见习偶像",
193
"image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
194
"image_small": "http://i0.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
195
"level": "普通勋章",
196
"condition": "所有自制视频总播放数>=10万"
197
},
198
"is_followed": true,
199
"top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
200
"theme": {},
201
"sys_notice": {},
202
"live_room": {
203
"roomStatus": 1,
204
"liveStatus": 0,
205
"url": "https://live.bilibili.com/1024",
206
"title": "劲夫专业户",
207
"cover": "http://i0.hdslb.com/bfs/vc/266c730abfe5a4716844b1f4d2e308a0020199ee.jpg",
208
"online": 16433,
209
"roomid": 1024,
210
"roundStatus": 0,
211
"broadcast_type": 0
212
}
213
}
169
214
}
170
215
```
171
216
@@ -442,8 +487,6 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
442
487
443
488
认证方式：Cookie（SESSDATA）
444
489
445
功能同「[登录用户信息1](../login/login_info.md#登录用户信息1（完整）)」
446
447
490
**json回复：**
448
491
449
492
根对象：
@@ -549,68 +592,73 @@ curl -G 'api.bilibili.com/x/space/myinfo' \
549
592
550
593
```json
551
594
{
552
"code": 0,
553
"message": "0",
554
"ttl": 1,
555
"data": {
556
"mid": 293793435,
557
"name": "社会易姐QwQ",
558
"sex": "男",
559
"face": "http://i2.hdslb.com/bfs/face/480e2e98513aaeb65d2f2c76dbae750c4de722e9.jpg",
560
"sign": "咕咕咕咕咕",
561
"rank": 10000,
562
"level": 5,
563
"jointime": 0,
564
"moral": 70,
565
"silence": 0,
566
"email_status": 1,
567
"tel_status": 1,
568
"identification": 1,
569
"vip": {
570
"type": 2,
571
"status": 1,
572
"due_date": 1612454400000,
573
"vip_pay_type": 1,
574
"theme_type": 0,
575
"label": {
576
"path": ""
577
}
578
},
579
"pendant": {
580
"pid": 294,
581
"name": "茶啊二中",
582
"image": "http://i0.hdslb.com/bfs/face/5bb7bef5107e448892ab54539298d50eb678de05.png",
583
"expire": 0
584
},
585
"nameplate": {
586
"nid": 0,
587
"name": "",
588
"image": "",
589
"image_small": "",
590
"level": "",
591
"condition": ""
592
},
593
"official": {
594
"role": 0,
595
"title": "",
596
"desc": "",
597
"type": -1
598
},
599
"birthday": 1015257600,
600
"is_tourist": 0,
601
"is_fake_account": 0,
602
"pin_prompting": 0,
603
"is_deleted": 0,
604
"level_exp": {
605
"current_level": 5,
606
"current_min": 10800,
607
"current_exp": 13985,
608
"next_exp": 28800
609
},
610
"coins": 10.4,
611
"following": 358,
612
"follower": 358
613
}
595
"code": 0,
596
"message": "0",
597
"ttl": 1,
598
"data": {
599
"mid": 293793435,
600
"name": "社会易姐QwQ",
601
"sex": "男",
602
"face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
603
"sign": "高中技术宅一枚，爱好MC&电子&8-bit音乐&数码&编程，粉丝群：1136462265",
604
"rank": 10000,
605
"level": 5,
606
"jointime": 0,
607
"moral": 70,
608
"silence": 0,
609
"email_status": 1,
610
"tel_status": 1,
611
"identification": 1,
612
"vip": {
613
"type": 2,
614
"status": 1,
615
"due_date": 1612454400000,
616
"vip_pay_type": 1,
617
"theme_type": 0,
618
"label": {
619
"path": "",
620
"text": "年度大会员",
621
"label_theme": "annual_vip"
622
},
623
"avatar_subscript": 1,
624
"nickname_color": "#FB7299"
625
},
626
"pendant": {
627
"pid": 2511,
628
"name": "初音未来13周年",
629
"image": "http://i0.hdslb.com/bfs/garb/item/4f8f3f1f2d47f0dad84f66aa57acd4409ea46361.png",
630
"expire": 0,
631
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp"
632
},
633
"nameplate": {
634
"nid": 4,
635
"name": "青铜殿堂",
636
"image": "http://i2.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
637
"image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
638
"level": "普通勋章",
639
"condition": "单个自制视频总播放数>=1万"
640
},
641
"official": {
642
"role": 0,
643
"title": "",
644
"desc": "",
645
"type": -1
646
},
647
"birthday": 1015257600,
648
"is_tourist": 0,
649
"is_fake_account": 0,
650
"pin_prompting": 0,
651
"is_deleted": 0,
652
"level_exp": {
653
"current_level": 5,
654
"current_min": 10800,
655
"current_exp": 20528,
656
"next_exp": 28800
657
},
658
"coins": 40.2,
659
"following": 888,
660
"follower": 888
661
}
614
662
}
615
663
```
616
664
@@ -3,6 +3,8 @@
3
3
- [查询用户粉丝明细](#查询用户粉丝明细)
4
4
- [查询用户关注明细](#查询用户关注明细)
5
5
- [查询共同关注明细](#查询共同关注明细)
6
- [查询悄悄关注明细](#查询悄悄关注明细)
7
- [查询黑名单明细](#查询黑名单明细)
6
8
- [操作用户关系（关注/取关 等）](#操作用户关系（关注/取关 等）)
7
9
- [批量操作用户关系（仅关注&拉黑）](#批量操作用户关系（仅关注&拉黑）)
8
10
- [查询用户与自己关系（仅查关注）](#查询用户与自己关系（仅查关注）)
@@ -70,40 +72,40 @@
70
72
| n | obj | 粉丝（n+1） | 按照关注顺序排列 |
71
73
| …… | obj | …… | …… |
72
74
73
数组`list`中的对象：
75
`list`中的对象：
74
76
75
77
| 字段 | 类型 | 内容 | 备注 |
76
78
| --------------- | ---- | ------------ | --------------------------------------- |
77
79
| mid | num | 用户UID | |
78
80
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
79
81
| mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 |
80
| tag | null | | 作用尚不明确 |
81
| special | num | 0 | 作用尚不明确 |
82
| tag | null | | |
83
| special | num | 0 | |
82
84
| uname | str | 用户昵称 | |
83
85
| face | str | 用户头像url | |
84
86
| sign | str | 用户签名 | |
85
87
| official_verify | obj | 认证信息 | |
86
88
| vip | obj | 会员信息 | |
87
89
88
数组`list`中的对象中的`official_verify`对象：
90
`list`中的对象中的`official_verify`对象：
89
91
90
92
| 字段 | 类型 | 内容 | 备注 |
91
93
| ---- | ---- | ------------ | ------------------- |
92
94
| type | num | 用户认证类型 | -1：无<br />1：认证 |
93
95
| desc | str | 用户认证信息 | 无为空 |
94
96
95
数组`list`中的对象中的`vip`对象：
97
`list`中的对象中的`vip`对象：
96
98
97
| 字段 | 类型 | 内容 | 备注 |
98
| ------------- | ---- | ------------ | ----------------------------------- |
99
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
100
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
101
| dueRemark | str | 空 | 作用尚不明确 |
102
| accessStatus | num | 0 | 作用尚不明确 |
103
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
104
| vipStatusWarn | str | 空 | 作用尚不明确 |
105
| themeType | num | 0 | 作用尚不明确 |
106
| label | obj | ？？？ | 作用尚不明确 |
99
| 字段 | 类型 | 内容 | 备注 |
100
| ------------- | ---- | ------------ | ----------------------------------------------- |
101
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
102
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
103
| dueRemark | str | 空 | 作用尚不明确 |
104
| accessStatus | num | 0 | 作用尚不明确 |
105
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
106
| vipStatusWarn | str | 空 | 作用尚不明确 |
107
| themeType | num | 0 | 作用尚不明确 |
108
| label | obj | ？？？ | 作用尚不明确 |
107
109
108
110
`vip`中的`label`对象：
109
111
@@ -247,7 +249,7 @@ data 对象：
247
249
| mid | num | 用户UID | |
248
250
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
249
251
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
250
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | 作用尚不明确 |
252
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
251
253
| special | num | 特别关注标志 | 0：否<br />1：是 |
252
254
| uname | str | 用户昵称 | |
253
255
| face | str | 用户头像url | |
@@ -263,25 +265,25 @@ data 对象：
263
265
| n | num | 位于分组（n+1）的分组ID | |
264
266
| …… | num | …… | …… |
265
267
266
数组`list`中的对象中的`official_verify`对象：
268
`list`中的对象中的`official_verify`对象：
267
269
268
270
| 字段 | 类型 | 内容 | 备注 |
269
271
| ---- | ---- | ------------ | ------------------- |
270
| type | num | 用户认证类型 | -1：无<br />0：认证 |
272
| type | num | 用户认证类型 | -1：无<br />1：认证 |
271
273
| desc | str | 用户认证信息 | 无为空 |
272
274
273
数组`list`中的对象中的`vip`对象：
275
`list`中的对象中的`vip`对象：
274
276
275
| 字段 | 类型 | 内容 | 备注 |
276
| ------------- | ---- | ------------ | ----------------------------------- |
277
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
278
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
279
| dueRemark | str | 空 | 作用尚不明确 |
280
| accessStatus | num | 0 | 作用尚不明确 |
281
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
282
| vipStatusWarn | str | 空 | 作用尚不明确 |
283
| themeType | num | 0 | 作用尚不明确 |
284
| label | obj | ？？？ | 作用尚不明确 |
277
| 字段 | 类型 | 内容 | 备注 |
278
| ------------- | ---- | ------------ | ----------------------------------------------- |
279
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
280
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
281
| dueRemark | str | 空 | 作用尚不明确 |
282
| accessStatus | num | 0 | 作用尚不明确 |
283
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
284
| vipStatusWarn | str | 空 | 作用尚不明确 |
285
| themeType | num | 0 | 作用尚不明确 |
286
| label | obj | ？？？ | 作用尚不明确 |
285
287
286
288
`vip`中的`label`对象：
287
289
@@ -418,18 +420,18 @@ data 对象：
418
420
419
421
数组`list`中的对象：
420
422
421
| 字段 | 类型 | 内容 | 备注 |
422
| --------------- | --------------------------------------- | ------------ | --------------------------------------- |
423
| mid | num | 用户UID | |
424
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
425
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
426
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | 作用尚不明确 |
427
| special | num | 特别关注标志 | 0：否<br />1：是 |
428
| uname | str | 用户昵称 | |
429
| face | str | 用户头像url | |
430
| sign | str | 用户签名 | |
431
| official_verify | obj | 认证信息 | |
432
| vip | obj | 会员信息 | |
423
| 字段 | 类型 | 内容 | 备注 |
424
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
425
| mid | num | 用户UID | |
426
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
427
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
428
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
429
| special | num | 特别关注标志 | 0：否<br />1：是 |
430
| uname | str | 用户昵称 | |
431
| face | str | 用户头像url | |
432
| sign | str | 用户签名 | |
433
| official_verify | obj | 认证信息 | |
434
| vip | obj | 会员信息 | |
433
435
434
436
数组`list`中的对象中的`tag`数组：
435
437
@@ -439,25 +441,25 @@ data 对象：
439
441
| n | num | 位于分组（n+1）的分组ID | |
440
442
| …… | num | …… | …… |
441
443
442
数组`list`中的对象中的`official_verify`对象：
444
`list`中的对象中的`official_verify`对象：
443
445
444
446
| 字段 | 类型 | 内容 | 备注 |
445
447
| ---- | ---- | ------------ | ------------------- |
446
| type | num | 用户认证类型 | -1：无<br />0：认证 |
448
| type | num | 用户认证类型 | -1：无<br />1：认证 |
447
449
| desc | str | 用户认证信息 | 无为空 |
448
450
449
数组`list`中的对象中的`vip`对象：
451
`list`中的对象中的`vip`对象：
450
452
451
| 字段 | 类型 | 内容 | 备注 |
452
| ------------- | ---- | ------------ | ----------------------------------- |
453
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
454
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
455
| dueRemark | str | 空 | 作用尚不明确 |
456
| accessStatus | num | 0 | 作用尚不明确 |
457
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
458
| vipStatusWarn | str | 空 | 作用尚不明确 |
459
| themeType | num | 0 | 作用尚不明确 |
460
| label | obj | ？？？ | 作用尚不明确 |
453
| 字段 | 类型 | 内容 | 备注 |
454
| ------------- | ---- | ------------ | ----------------------------------------------- |
455
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
456
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
457
| dueRemark | str | 空 | 作用尚不明确 |
458
| accessStatus | num | 0 | 作用尚不明确 |
459
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
460
| vipStatusWarn | str | 空 | 作用尚不明确 |
461
| themeType | num | 0 | 作用尚不明确 |
462
| label | obj | ？？？ | 作用尚不明确 |
461
463
462
464
`vip`中的`label`对象：
463
465
@@ -550,6 +552,322 @@ curl -G 'http://api.bilibili.com/x/relation/same/followings' \
550
552
551
553
</details>
552
554
555
## 查询悄悄关注明细
556
557
<img src="/imgs/relation.svg" width="100" height="100" />
558
559
> http://api.bilibili.com/x/relation/whispers
560
561
*请求方式：GET*
562
563
认证方式：Cookie（SESSDATA）或APP
564
565
**url参数：**
566
567
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
568
| ---------- | ---- | ------------ | ----------- | -------- |
569
| access_key | str | APP登录Token | APP方式必要 | |
570
| ps | num | 每页项数 | 非必要 | 默认为50 |
571
| pn | num | 页码 | 非必要 | 默认为1 |
572
573
**json回复：**
574
575
根对象：
576
577
| 字段 | 类型 | 内容 | 备注 |
578
| ------- | ---- | -------- | ------------------------------------------------- |
579
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
580
| message | str | 错误信息 | 默认为0 |
581
| ttl | num | 1 | |
582
| data | obj | 信息本体 | |
583
584
data 对象：
585
586
| 字段 | 类型 | 内容 | 备注 |
587
| ---------- | ----- | -------- | ------------ |
588
| list | array | 明细列表 | |
589
| re_version | num | ？？？ | 作用尚不明确 |
590
591
`data`中的`list`数组：
592
593
| 项 | 类型 | 内容 | 备注 |
594
| ---- | ---- | ----------- | ---------------- |
595
| 0 | obj | 关注1 | |
596
| n | obj | 关注（n+1） | 按照关注顺序排列 |
597
| …… | obj | …… | …… |
598
599
数组`list`中的对象：
600
601
| 字段 | 类型 | 内容 | 备注 |
602
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
603
| mid | num | 用户UID | |
604
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
605
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
606
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
607
| special | num | 特别关注标志 | 0：否<br />1：是 |
608
| uname | str | 用户昵称 | |
609
| face | str | 用户头像url | |
610
| sign | str | 用户签名 | |
611
| official_verify | obj | 认证信息 | |
612
| vip | obj | 会员信息 | |
613
614
数组`list`中的对象中的`tag`数组：
615
616
| 项 | 类型 | 内容 | 备注 |
617
| ---- | ---- | ----------------------- | ---- |
618
| 0 | num | 位于分组1的分组ID | |
619
| n | num | 位于分组（n+1）的分组ID | |
620
| …… | num | …… | …… |
621
622
`list`中的对象中的`official_verify`对象：
623
624
| 字段 | 类型 | 内容 | 备注 |
625
| ---- | ---- | ------------ | ------------------- |
626
| type | num | 用户认证类型 | -1：无<br />1：认证 |
627
| desc | str | 用户认证信息 | 无为空 |
628
629
`list`中的对象中的`vip`对象：
630
631
| 字段 | 类型 | 内容 | 备注 |
632
| ------------- | ---- | ------------ | ----------------------------------------------- |
633
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
634
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
635
| dueRemark | str | 空 | 作用尚不明确 |
636
| accessStatus | num | 0 | 作用尚不明确 |
637
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
638
| vipStatusWarn | str | 空 | 作用尚不明确 |
639
| themeType | num | 0 | 作用尚不明确 |
640
| label | obj | ？？？ | 作用尚不明确 |
641
642
`vip`中的`label`对象：
643
644
| 字段 | 类型 | 内容 | 备注 |
645
| ---- | ---- | ---- | ------------ |
646
| path | str | 空 | 作用尚不明确 |
647
648
**示例：**
649
650
获取悄悄关注明细
651
652
```shell
653
curl -G 'http://api.bilibili.com/x/relation/whispers' \
654
--data-urlencode 'ps=2' \
655
--data-urlencode 'pn=1' \
656
-b 'SESSDATA=xxx'
657
```
658
659
<details>
660
<summary>查看响应示例：</summary>
661
662
663
```json
664
{
665
"code": 0,
666
"message": "0",
667
"ttl": 1,
668
"data": {
669
"list": [
670
{
671
"mid": 178429408,
672
"attribute": 1,
673
"mtime": 1605972105,
674
"tag": null,
675
"special": 0,
676
"uname": "老弟一号",
677
"face": "http://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
678
"sign": "萌新硬件玩家，前垃圾佬～(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328",
679
"official_verify": {
680
"type": 0,
681
"desc": "知识领域优质UP主"
682
},
683
"vip": {
684
"vipType": 2,
685
"vipDueDate": 1632499200000,
686
"dueRemark": "",
687
"accessStatus": 0,
688
"vipStatus": 1,
689
"vipStatusWarn": "",
690
"themeType": 0,
691
"label": {
692
"path": ""
693
}
694
}
695
}
696
],
697
"re_version": 2137574562
698
}
699
}
700
```
701
702
</details>
703
704
## 查询黑名单明细
705
706
> http://api.bilibili.com/x/relation/blacks
707
708
*请求方式：GET*
709
710
认证方式：Cookie（SESSDATA）或APP
711
712
**url参数：**
713
714
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
715
| ---------- | ---- | ------------ | ----------- | -------- |
716
| access_key | str | APP登录Token | APP方式必要 | |
717
| ps | num | 每页项数 | 非必要 | 默认为50 |
718
| pn | num | 页码 | 非必要 | 默认为1 |
719
720
**json回复：**
721
722
根对象：
723
724
| 字段 | 类型 | 内容 | 备注 |
725
| ------- | ---- | -------- | ------------------------------------------------- |
726
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
727
| message | str | 错误信息 | 默认为0 |
728
| ttl | num | 1 | |
729
| data | obj | 信息本体 | |
730
731
data 对象：
732
733
| 字段 | 类型 | 内容 | 备注 |
734
| ---------- | ----- | ------------ | ------------ |
735
| list | array | 明细列表 | |
736
| re_version | num | ？？？ | 作用尚不明确 |
737
| total | num | 黑名单总计数 | |
738
739
`data`中的`list`数组：
740
741
| 项 | 类型 | 内容 | 备注 |
742
| ---- | ---- | ----------- | ---------------- |
743
| 0 | obj | 关注1 | |
744
| n | obj | 关注（n+1） | 按照关注顺序排列 |
745
| …… | obj | …… | …… |
746
747
数组`list`中的对象：
748
749
| 字段 | 类型 | 内容 | 备注 |
750
| --------------- | ---- | ------------ | ---------------------- |
751
| mid | num | 用户UID | |
752
| attribute | num | 关注属性 | 128：已拉黑 |
753
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
754
| tag | null | | |
755
| special | num | 0 | |
756
| uname | str | 用户昵称 | |
757
| face | str | 用户头像url | |
758
| sign | str | 用户签名 | |
759
| official_verify | obj | 认证信息 | |
760
| vip | obj | 会员信息 | |
761
762
`list`中的对象中的`official_verify`对象：
763
764
| 字段 | 类型 | 内容 | 备注 |
765
| ---- | ---- | ------------ | ------------------- |
766
| type | num | 用户认证类型 | -1：无<br />1：认证 |
767
| desc | str | 用户认证信息 | 无为空 |
768
769
`list`中的对象中的`vip`对象：
770
771
| 字段 | 类型 | 内容 | 备注 |
772
| ------------- | ---- | ------------ | ----------------------------------------------- |
773
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
774
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
775
| dueRemark | str | 空 | 作用尚不明确 |
776
| accessStatus | num | 0 | 作用尚不明确 |
777
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
778
| vipStatusWarn | str | 空 | 作用尚不明确 |
779
| themeType | num | 0 | 作用尚不明确 |
780
| label | obj | ？？？ | 作用尚不明确 |
781
782
`vip`中的`label`对象：
783
784
| 字段 | 类型 | 内容 | 备注 |
785
| ---- | ---- | ---- | ------------ |
786
| path | str | 空 | 作用尚不明确 |
787
788
**示例：**
789
790
获取黑名单明细
791
792
```shell
793
curl -G 'http://api.bilibili.com/x/relation/blacks' \
794
--data-urlencode 'ps=2' \
795
--data-urlencode 'pn=1' \
796
-b 'SESSDATA=xxx'
797
```
798
799
<details>
800
<summary>查看响应示例：</summary>
801
802
803
```json
804
{
805
"code": 0,
806
"message": "0",
807
"ttl": 1,
808
"data": {
809
"list": [
810
{
811
"mid": 22179720,
812
"attribute": 128,
813
"mtime": 1603032789,
814
"tag": null,
815
"special": 0,
816
"uname": "咩2016",
817
"face": "http://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg",
818
"sign": "",
819
"official_verify": {
820
"type": 0,
821
"desc": ""
822
},
823
"vip": {
824
"vipType": 0,
825
"vipDueDate": 0,
826
"dueRemark": "",
827
"accessStatus": 0,
828
"vipStatus": 0,
829
"vipStatusWarn": "",
830
"themeType": 0,
831
"label": {
832
"path": ""
833
}
834
}
835
},
836
{
837
"mid": 16174624,
838
"attribute": 128,
839
"mtime": 1603026420,
840
"tag": null,
841
"special": 0,
842
"uname": "其实死亡没有那么痛",
843
"face": "http://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg",
844
"sign": "等我，我马上就来",
845
"official_verify": {
846
"type": 0,
847
"desc": ""
848
},
849
"vip": {
850
"vipType": 0,
851
"vipDueDate": 0,
852
"dueRemark": "",
853
"accessStatus": 0,
854
"vipStatus": 0,
855
"vipStatusWarn": "",
856
"themeType": 0,
857
"label": {
858
"path": ""
859
}
860
}
861
}
862
],
863
"re_version": 897205356,
864
"total": 2
865
}
866
}
867
```
868
869
</details>
870
553
871
## 操作用户关系（关注/取关 等）
554
872
555
873
<img src="/imgs/follow.svg" width="200" height="100" />