返回提交历史
Modified
README.md
+1
-1
Modified
docs/live/info.md
+167
-1
XFEstudio/bilibili-API-collect
增加获取直播间主播信息 (#1077)
* Update README.md * Update info.md
b328af7
代码差异
2 个文件
+168
-2
@@ -240,7 +240,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
240
240
- [ ] [直播红包](docs/live/redpocket.md)
241
241
- [ ] [直播间用户实用 API](docs/live/user.md)
242
242
- [x] [直播间禁言相关](docs/live/silent_user_manage.md)
243
- [ ] [关注UP直播情况](docs/live/follow_up_live)
243
- [ ] [关注UP直播情况](docs/live/follow_up_live.md)
244
244
- [ ] [转正答题](docs/newbie_exam)
245
245
- [x] [查询信息](docs/newbie_exam/info.md)
246
246
- [x] [拉取题目](docs/newbie_exam/fetch.md)
@@ -958,4 +958,170 @@ curl -L -X GET 'https://api.live.bilibili.com/xlive/web-room/v2/index/getRoomPla
958
958
}
959
959
```
960
960
961
</details>
961
</details>
962
963
964
965
966
967
## 获取直播间主播信息
968
969
> https://api.live.bilibili.com/live_user/v1/UserInfo/get_anchor_in_room
970
971
*请求方式: GET*
972
973
**URL参数：**
974
975
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
976
|---------|-----|------|-----|-------|
977
| roomid | num | 直播间号 | 必要 | 可以为短号 |
978
979
980
**json回复：**
981
982
983
根对象：
984
985
| 字段 | 类型 | 内容 | 备注 |
986
|---------|-----|------|-----------------|
987
| code | num | 返回值 | 0：成功 （直播间不存在也为0） |
988
| message | str | 错误信息 | |
989
| msg | str | 错误信息 | |
990
| data | obj | 信息本体 | |
991
992
993
994
`data`对象：
995
996
| 字段 | 类型 | 内容 | 备注 |
997
|-------------------------|-----------|--------|-----------------------------|
998
| info | obj | 主播信息 | |
999
| level | obj | 直播等级 | |
1000
| san | num | 主播san值 | 12满分 |
1001
1002
1003
`info`对象:
1004
1005
1006
| 字段 | 类型 | 内容 | 备注 |
1007
|-------------------|------|------------------|----------|
1008
| uid | num | 主播mid | |
1009
| uname | str | 主播用户名 | |
1010
| face | str | 主播头像URL | |
1011
| rank | str | 主播排名 | |
1012
| platform_user_level | num | 平台用户等级 | |
1013
| mobile_verify | num | 手机验证状态 | |
1014
| identification | num | 身份认证状态 | |
1015
| official_verify | obj | 认证信息 | |
1016
| vip_type | num | VIP类型 | |
1017
| gender | num | 主播性别 | -1：保密<br />0：女<br />1：男 |
1018
1019
1020
`info`中的`official_verify`对象:
1021
1022
| 字段 | 类型 | 内容 | 备注 |
1023
|------|------|----------|-----|
1024
| type | num | 主播认证类型 | -1：无<br />0：个人认证<br />1：机构认证 |
1025
| desc | str | 主播认证信息 | |
1026
| role | num | 未知 | |
1027
1028
`level`对象:
1029
1030
1031
1032
| 字段 | 类型 | 内容 | 备注 |
1033
|--------------|------|------------------|----------|
1034
| uid | num | 用户ID | |
1035
| cost | num | 消费金额 | |
1036
| rcost | num | 充值金额 | |
1037
| user_score | str | 用户积分 | |
1038
| vip | num | VIP状态 | |
1039
| vip_time | str | VIP到期时间 | |
1040
| svip | num | SVIP状态 | |
1041
| svip_time | str | SVIP到期时间 | |
1042
| update_time | str | 更新时间 | |
1043
| master_level | obj | 主播等级 | |
1044
| user_level | num | 用户等级 | |
1045
| color | num | 颜色值 | |
1046
| anchor_score | num | 主播积分 | |
1047
1048
1049
1050
`level` 中的 `master_level`对象:
1051
1052
| 字段 | 类型 | 内容 | 备注 |
1053
|-------------------|------|------------------|----------|
1054
| level | num | 主播等级 | |
1055
| color | num | 颜色值 | |
1056
| current | list | 当前积分 | |
1057
| next | list | 下一等级积分 | |
1058
| anchor_score | num | 主播积分 | |
1059
| upgrade_score | num | 升级积分 | |
1060
| master_level_color | num | 主播等级颜色值 | |
1061
| sort | str | 排名 | |
1062
1063
1064
**示例：**
1065
1066
查询`roomid=1`的直播间主播信息
1067
1068
```shell
1069
curl -G 'https://api.live.bilibili.com/live_user/v1/UserInfo/get_anchor_in_room' \
1070
--data-urlencode 'roomid=1'
1071
```
1072
1073
<details>
1074
<summary>查看响应示例：</summary>
1075
1076
```json
1077
{
1078
"code": 0,
1079
"msg": "success",
1080
"message": "success",
1081
"data": {
1082
"info": {
1083
"uid": 9617619,
1084
"uname": "哔哩哔哩直播",
1085
"face": "https://i0.hdslb.com/bfs/face/8f6a614a48a3813d90da7a11894ae56a59396fcd.jpg",
1086
"rank": "10000",
1087
"platform_user_level": 6,
1088
"mobile_verify": 1,
1089
"identification": 1,
1090
"official_verify": {
1091
"type": 1,
1092
"desc": "哔哩哔哩直播官方账号",
1093
"role": 3
1094
},
1095
"vip_type": 2,
1096
"gender": -1
1097
},
1098
"level": {
1099
"uid": 9617619,
1100
"cost": 7782673656,
1101
"rcost": 20199200291,
1102
"user_score": "0",
1103
"vip": 0,
1104
"vip_time": "0000-00-00 00:00:00",
1105
"svip": 0,
1106
"svip_time": "0000-00-00 00:00:00",
1107
"update_time": "2024-08-08 17:13:12",
1108
"master_level": {
1109
"level": 40,
1110
"color": 16746162,
1111
"current": [0, 147013810],
1112
"next": [0, 147013810],
1113
"anchor_score": 201992002,
1114
"upgrade_score": 0,
1115
"master_level_color": 16746162,
1116
"sort": "\u003E10000"
1117
},
1118
"user_level": 60,
1119
"color": 16752445,
1120
"anchor_score": 201992002
1121
},
1122
"san": 12
1123
}
1124
}
1125
```
1126
1127
</details>