返回提交历史
Modified
docs/user/info.md
+275
-19
XFEstudio/bilibili-API-collect
feat: add get users info
3c69d4d
代码差异
1 个文件
+275
-19
@@ -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}`对象：
967
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
```
941
1018
942
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以同时获取 40000 多个用户的信息）
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 | 用户权限等级 | |
@@ -986,7 +1246,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
986
1246
```shell
987
1247
curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
988
1248
--data-urlencode 'uids=1,2,3' \
989
-b 'SESSDATA=xxx'
990
1249
```
991
1250
992
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
}