返回提交历史
Modified
docs/user/info.md
+276
-20
Modified
docs/user/relation.md
+15
-17
XFEstudio/bilibili-API-collect
feat: 添加获取多用户信息接口，完善用户关系文档 (#1044)
* feat: add get users info * 将 #983 中对此文件的更改合并到此 PR 中 * fix: typo
ea555af
代码差异
2 个文件
+291
-37
@@ -933,18 +933,279 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
933
933
934
934
## 多用户详细信息
935
935
936
> https://api.vc.bilibili.com/account/v1/user/cards
936
> https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards
937
937
938
938
*请求方式：GET*
939
939
940
认证方式：Cookie(SESSDATA)
940
可以同时获取较多的用户信息（据测试可以一次性获取 2000 多个用户的信息；若获取更多用户信息可能会返回 -504 `服务调用超时`）
941
942
**url参数：**
943
944
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
945
| ------ | ---- | ----------------- | ------ | ------------------- |
946
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 |
947
948
**json回复：**
949
950
根对象：
951
952
| 字段 | 类型 | 内容 | 备注 |
953
| ------- | ----- | -------- | --------------------------- |
954
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
955
| message | str | 错误信息 | 默认为0 |
956
| ttl | num | 1 | |
957
| data | obj | 信息本体 | 用户信息随机排序 |
958
959
`data`对象：
960
961
| 字段 | 类型 | 内容 | 备注 |
962
| --------- | ---- | ----------------------- | ---- |
963
| {用户mid} | obj | 该mid对应的用户信息 | |
964
| …… | obj | …… | …… |
965
966
`data`中的`{用户mid}`对象：
941
967
942
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以同时获取 40000 多个用户的信息）
968
| 字段 | 类型 | 内容 | 备注 |
969
| ------------ | ---- | ------------------- | -------------------- |
970
| face | str | 头像链接 | |
971
| face_nft | num | 是否为 NFT 头像 | 0：不是 NFT 头像<br />1：是 NFT 头像 |
972
| face_nft_new | num | 是否为新版 NFT 头像 | |
973
| mid | str | mid | |
974
| name | str | 昵称 | |
975
| name_render | 有效时：obj<br />无效时：null | 昵称渲染信息 | |
976
| nameplate | 有效时：obj<br />无效时：null | 勋章信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.nameplate` 对象 |
977
| official | obj | 认证信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.official` 对象 |
978
| pendant | 有效时：obj<br />无效时：null| 头像框信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.pendant` 对象，其中有些类型为 `num` 的字段在本接口中类型为 `str` |
979
| vip | obj | 会员信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.vip` 对象，其中有些类型为 `num` 的字段在本接口中类型为 `str` |
980
981
`{用户mid}`中的`name_render`对象：
982
983
| 字段 | 类型 | 内容 | 备注 |
984
| ------------- | ---- | --------------------------- | ---------------- |
985
| colors_info | obj | 昵称颜色信息（？） | **作用尚不明确** |
986
| render_scheme | str | `"Default"` 或 `"Colorful"` | **作用尚不明确** |
987
988
`name_render`中的`colors_info`对象：
989
990
| 字段 | 类型 | 内容 | 备注 |
991
| --------- | ----- | -------------- | ---------------- |
992
| color | array | 昵称颜色（？） | **作用尚不明确** |
993
| color_ids | array | `["6"]` | **作用尚不明确** |
994
995
`color`数组：
996
997
| 项 | 类型 | 内容 | 备注 |
998
| ---- | ---- | --------- | ---- |
999
| 0 | obj | 颜色1 | |
1000
| n | obj | 颜色(n+1) | |
1001
| …… | obj | …… | …… |
1002
1003
`color`数组中的对象：
1004
1005
| 字段 | 类型 | 内容 | 备注 |
1006
| ----------- | ---- | ---------------- | ---------------- |
1007
| color_day | str | 浅色模式昵称颜色 | HEX颜色代码 |
1008
| color_night | str | 深色模式昵称颜色 | HEX颜色代码 |
1009
1010
**示例：**
1011
1012
查询用户`uids=1,2,3`的详细信息
1013
1014
```shell
1015
curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
1016
--data-urlencode 'uids=1,2,3'
1017
```
1018
1019
<details>
1020
<summary>查看响应示例：</summary>
1021
1022
```json
1023
{
1024
"code": 0,
1025
"message": "0",
1026
"ttl": 1,
1027
"data": {
1028
"1": {
1029
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
1030
"face_nft": 0,
1031
"face_nft_new": 0,
1032
"mid": "1",
1033
"name": "bishi",
1034
"name_render": {
1035
"colors_info": { "color": [], "color_ids": [ "6" ] },
1036
"render_scheme": "Default"
1037
},
1038
"nameplate": null,
1039
"official": { "desc": "", "role": 0, "title": "", "type": -1 },
1040
"pendant": null,
1041
"vip": {
1042
"avatar_icon": {
1043
"icon_resource": {
1044
"type": "ICON_RES_TYPE_IMAGE",
1045
"url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png"
1046
},
1047
"icon_type": "ICON_TYPE_VIP_ACTIVITY"
1048
},
1049
"avatar_subscript": 1,
1050
"avatar_subscript_url": "",
1051
"due_date": "1883059200000",
1052
"label": {
1053
"bg_color": "#FB7299",
1054
"bg_style": 1,
1055
"border_color": "",
1056
"img_label_uri_hans": "",
1057
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/fb0a74b14d6a4e119ae301ba2693febeda051030.png",
1058
"img_label_uri_hant": "",
1059
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png",
1060
"label_theme": "ten_annual_vip",
1061
"path": "",
1062
"text": "十年大会员",
1063
"text_color": "#FFFFFF",
1064
"use_img_label": true
1065
},
1066
"nickname_color": "#FB7299",
1067
"role": "7",
1068
"status": 1,
1069
"theme_type": 0,
1070
"tv_due_date": "1633622400",
1071
"tv_vip_pay_type": 0,
1072
"tv_vip_status": 0,
1073
"type": 2,
1074
"vip_pay_type": 1
1075
}
1076
},
1077
"2": {
1078
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
1079
"face_nft": 0,
1080
"face_nft_new": 0,
1081
"mid": "2",
1082
"name": "碧诗",
1083
"name_render": {
1084
"colors_info": { "color": [], "color_ids": [ "6" ] },
1085
"render_scheme": "Default"
1086
},
1087
"nameplate": {
1088
"condition": "所有自制视频总播放数>=10万",
1089
"image": "https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
1090
"image_small": "https://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
1091
"level": "普通勋章",
1092
"name": "见习偶像",
1093
"nid": 10
1094
},
1095
"official": { "desc": "", "role": 2, "title": "bilibili创始人（站长）", "type": 0 },
1096
"pendant": {
1097
"expire": "0",
1098
"image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png",
1099
"image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp",
1100
"image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png",
1101
"n_pid": "32257",
1102
"name": "EveOneCat2",
1103
"pid": 32257
1104
},
1105
"vip": {
1106
"avatar_icon": {
1107
"icon_resource": {
1108
"type": "ICON_RES_TYPE_IMAGE",
1109
"url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png"
1110
},
1111
"icon_type": "ICON_TYPE_VIP_ACTIVITY"
1112
},
1113
"avatar_subscript": 1,
1114
"avatar_subscript_url": "",
1115
"due_date": "3968841600000",
1116
"label": {
1117
"bg_color": "#FB7299",
1118
"bg_style": 1,
1119
"border_color": "",
1120
"img_label_uri_hans": "",
1121
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/53845a8ab8b226131c5d89b198d4b61de91d0aa2.png",
1122
"img_label_uri_hant": "",
1123
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png",
1124
"label_theme": "ten_annual_vip",
1125
"path": "",
1126
"text": "十年大会员",
1127
"text_color": "#FFFFFF",
1128
"use_img_label": true
1129
},
1130
"nickname_color": "#FB7299",
1131
"role": "7",
1132
"status": 1,
1133
"theme_type": 0,
1134
"tv_due_date": "2003500800",
1135
"tv_vip_pay_type": 1,
1136
"tv_vip_status": 1,
1137
"type": 2,
1138
"vip_pay_type": 0
1139
}
1140
},
1141
"3": {
1142
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
1143
"face_nft": 0,
1144
"face_nft_new": 0,
1145
"mid": "3",
1146
"name": "囧囧倉",
1147
"name_render": {
1148
"colors_info": {
1149
"color": [
1150
{ "color_day": "#CB7919", "color_night": "#E2963C" },
1151
{ "color_day": "#E6A75B", "color_night": "#E6A75B" },
1152
{ "color_day": "#E9BD67", "color_night": "#F8CE7E" }
1153
],
1154
"color_ids": [ "6" ]
1155
},
1156
"render_scheme": "Colorful"
1157
},
1158
"nameplate": null,
1159
"official": { "desc": "", "role": 0, "title": "", "type": -1 },
1160
"pendant": null,
1161
"vip": {
1162
"avatar_icon": null,
1163
"avatar_subscript": 0,
1164
"avatar_subscript_url": "",
1165
"due_date": "0",
1166
"label": {
1167
"bg_color": "",
1168
"bg_style": 0,
1169
"border_color": "",
1170
"img_label_uri_hans": "",
1171
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
1172
"img_label_uri_hant": "",
1173
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png",
1174
"label_theme": "",
1175
"path": "",
1176
"text": "",
1177
"text_color": "",
1178
"use_img_label": true
1179
},
1180
"nickname_color": "",
1181
"role": "0",
1182
"status": 0,
1183
"theme_type": 0,
1184
"tv_due_date": "0",
1185
"tv_vip_pay_type": 0,
1186
"tv_vip_status": 0,
1187
"type": 0,
1188
"vip_pay_type": 0
1189
}
1190
}
1191
}
1192
}
1193
```
1194
1195
</details>
1196
1197
## 多用户详细信息2
1198
1199
> https://api.vc.bilibili.com/account/v1/user/cards
1200
1201
*请求方式：GET*
1202
1203
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以一次性获取 40000 多个用户的信息）
943
1204
944
1205
**url参数：**
945
1206
946
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
947
| ------ | ---- | ----------------- | ------ | --------------------------------- |
1207
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1208
| ------ | ---- | ----------------- | ------ | ------------------- |
948
1209
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 |
949
1210
950
1211
**json回复：**
@@ -954,8 +1215,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
954
1215
| 字段 | 类型 | 内容 | 备注 |
955
1216
| ------- | ----- | -------- | --------------------------- |
956
1217
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
957
| msg | str | 错误信息 | 默认为空 |
958
| message | str | 错误信息 | 默认为空 |
1218
| message | str | 错误信息 | 默认为0 |
1219
| ttl | num | 1 | |
959
1220
| data | array | 信息本体 | 用户信息随机排序 |
960
1221
961
1222
`data`数组：
@@ -972,7 +1233,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
972
1233
| ------- | ---- | ------------ | -------------------- |
973
1234
| mid | num | mid | |
974
1235
| name | str | 昵称 | |
975
| sex | str | 性别 | 男/女/保密 |
976
1236
| face | str | 头像链接 | |
977
1237
| sign | str | 签名 | |
978
1238
| rank | num | 用户权限等级 | |
@@ -985,8 +1245,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
985
1245
986
1246
```shell
987
1247
curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
988
-b 'SESSDATA=xxx'
1248
--data-urlencode 'uids=1,2,3'
989
1249
```
990
1250
991
1251
<details>
@@ -995,34 +1254,31 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
995
1254
```json
996
1255
{
997
1256
"code": 0,
998
"msg": "",
999
1257
"message": "",
1258
"ttl": 1,
1000
1259
"data": [{
1001
1260
"mid": 1,
1002
1261
"name": "bishi",
1003
"sex": "男",
1004
"face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
1262
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
1005
1263
"sign": "",
1006
1264
"rank": 10000,
1007
"level": 4,
1265
"level": 6,
1008
1266
"silence": 0
1009
1267
}, {
1010
1268
"mid": 2,
1011
1269
"name": "碧诗",
1012
"sex": "男",
1013
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
1014
"sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”",
1270
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
1271
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
1015
1272
"rank": 20000,
1016
1273
"level": 6,
1017
1274
"silence": 0
1018
1275
}, {
1019
1276
"mid": 3,
1020
1277
"name": "囧囧倉",
1021
"sex": "男",
1022
"face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
1278
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
1023
1279
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
1024
1280
"rank": 10000,
1025
"level": 5,
1281
"level": 6,
1026
1282
"silence": 0
1027
1283
}]
1028
1284
}
@@ -11,7 +11,7 @@
11
11
| 字段 | 类型 | 内容 | 备注 |
12
12
| --------------- | ------------------------------------------- | -------------------------- | ------------------------------------------------------------ |
13
13
| mid | num | 用户 mid | |
14
| attribute | num | 对方对于**自己**的关系属性 | 0：未关注<br />1：悄悄关注（现已下线）<br />2：已关注<br />6：已互粉<br />128：已拉黑 |
14
| attribute | num | 对方对于**自己**的关系属性 | 0：未关注<br />~~1：悄悄关注（现已下线）~~<br />2：已关注<br />6：已互粉<br />128：已拉黑 |
15
15
| mtime | num | 对方关注目标用户时间 | 秒级时间戳<br />互关后刷新 |
16
16
| tag | 默认分组：null<br />存在至少一个分组：array | 目标用户将对方分组到的 id | |
17
17
| special | num | 目标用户特别关注对方标识 | 0：否<br />1：是 |
@@ -97,7 +97,7 @@
97
97
98
98
| 字段 | 类型 | 内容 | 备注 |
99
99
| ------- | ---- | -------- | ----------------------------------------------------- |
100
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-352：请求被拦截<br />-400：请求错误<br />22007：访问超过 5 页 |
100
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-352：请求被拦截<br />-400：请求错误<br />22118：由于该用户隐私设置，粉丝列表不可见 |
101
101
| message | str | 错误信息 | 默认为 0 |
102
102
| ttl | num | 1 | |
103
103
| data | obj | 信息本体 | |
@@ -368,7 +368,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
368
368
369
369
| 项 | 类型 | 内容 | 备注 |
370
370
| ---- | ---- | ----------- | --------------------------------------------- |
371
| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构不同 |
371
| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构**不同** |
372
372
| n | obj | 关注（n+1） | 按照添加顺序排列 |
373
373
| …… | obj | …… | …… |
374
374
@@ -501,9 +501,7 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
501
501
502
502
</details>
503
503
504
## 查询用户关注明细3
505
506
<img src="../../assets/img/relation.svg" width="100" height="100" />
504
### 查询用户关注明细3
507
505
508
506
> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
509
507
@@ -1289,15 +1287,15 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
1289
1287
1290
1288
操作代码`act`：
1291
1289
1292
| 代码 | 含义 |
1293
| ---- | ------------ |
1294
| 1 | 关注 |
1295
| 2 | 取关 |
1296
| 3 | 悄悄关注 |
1297
| 4 | 取消悄悄关注 |
1298
| 5 | 拉黑 |
1299
| 6 | 取消拉黑 |
1300
| 7 | 踢出粉丝 |
1290
| 代码 | 含义 | 备注 |
1291
| ---- | ------------ | ------------------------------------------------ |
1292
| 1 | 关注 | 无法对已注销或不存在的用户进行此操作 |
1293
| 2 | 取关 | |
1294
| 3 | 悄悄关注 | 现已下线，使用本操作代码请求接口会提示“请求错误” |
1295
| 4 | 取消悄悄关注 | |
1296
| 5 | 拉黑 | 无法对已注销或不存在的用户进行此操作 |
1297
| 6 | 取消拉黑 | |
1298
| 7 | 踢出粉丝 | |
1301
1299
1302
1300
**json回复：**
1303
1301
@@ -1305,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
1305
1303
1306
1304
| 字段 | 类型 | 内容 | 备注 |
1307
1305
| ------- | ---- | -------- | ------------------------------------------------------------ |
1308
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22003：用户位于黑名单 |
1306
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22002：因对方隐私设置，你还不能关注<br />22003：关注失败，请将该用户移除黑名单之后再试<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />22120：重复加入黑名单<br />40061：用户不存在 |
1309
1307
| message | str | 错误信息 | 默认为0 |
1310
1308
| ttl | num | 1 | |
1311
1309
@@ -1684,7 +1682,7 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \
1684
1682
1685
1683
| 项 | 类型 | 内容 | 备注 |
1686
1684
| ---- | ---- | ----------- | ---- |
1687
| 1 | obj | 分组 1 | |
1685
| 0 | obj | 分组 1 | |
1688
1686
| n | obj | 分组（n+1） | |
1689
1687
| …… | num | …… | …… |
1690
1688