返回提交历史
Modified
live/info.md
+150
-1
XFEstudio/bilibili-API-collect
Update info.md (#132)
adfb20f
代码差异
1 个文件
+150
-1
@@ -2,6 +2,7 @@
2
2
3
3
- [获取用户对应的直播间状态](#获取用户对应的直播间状态)
4
4
- [获取房间页初始化信息](#获取房间页初始化信息)
5
- [获取主播信息](#获取主播信息)
5
6
6
7
---
7
8
@@ -100,7 +101,6 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
100
101
| message | str | 错误信息 | 默认为ok |
101
102
| data | obj | 信息本体 | |
102
103
103
104
104
`data`对象：
105
105
106
106
| 字段 | 类型 | 内容 | 备注 |
@@ -161,3 +161,152 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
161
161
```
162
162
163
163
</details>
164
165
## 获取主播信息
166
167
> http://api.live.bilibili.com/live_user/v1/Master/info
168
169
*请求方式：GET*
170
171
**url参数：**
172
173
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
174
| ------ | ---- | ----------- | ------ | ---- |
175
| uid | num | 目标用户UID | 必要 | |
176
177
**json回复：**
178
179
根对象：
180
181
| 字段 | 类型 | 内容 | 备注 |
182
| ------- | ---- | -------- | ------------------------ |
183
| code | num | 返回值 | 0：成功<br />1：参数错误 |
184
| msg | str | 错误信息 | 默认为空 |
185
| message | str | 错误信息 | 默认为空 |
186
| data | obj | 信息本体 | |
187
188
`data`对象：
189
190
| 字段 | 类型 | 内容 | 备注 |
191
| -------------- | ---- | ---------------- | ---------------- |
192
| info | obj | 主播信息 | |
193
| exp | obj | 经验等级 | |
194
| follower_num | num | 主播粉丝数 | |
195
| room_id | num | 直播间ID（短号） | |
196
| medal_name | str | 粉丝勋章名 | |
197
| glory_count | int | 主播荣誉数 | |
198
| pendant | str | 直播间头像框url | |
199
| link_group_num | int | 0 | **作用尚不明确** |
200
| room_news | obj | 主播公告 | |
201
202
`info`对象：
203
204
| 字段 | 类型 | 内容 | 备注 |
205
| --------------- | ---- | ----------- | ------------------------------ |
206
| uid | num | 主播UID | |
207
| uname | str | 主播用户名 | |
208
| face | str | 主播头像url | |
209
| official_verify | obj | 认证信息 | |
210
| gender | num | 主播性别 | -1：保密<br />0：女<br />1：男 |
211
212
`info`中的`official_verify`对象：
213
| 字段 | 类型 | 内容 | 备注 |
214
| ---- | ---- | ------------ | ---------------------------------------- |
215
| type | num | 主播认证类型 | -1：无<br />0：个人认证<br />1：机构认证 |
216
| desc | str | 主播认证信息 | |
217
218
`exp`对象：
219
220
| 字段 | 类型 | 内容 | 备注 |
221
| ------------ | ---- | -------- | ---- |
222
| master_level | obj | 主播等级 | |
223
224
`exp`中的`master_level`对象：
225
226
| 字段 | 类型 | 内容 | 备注 |
227
| ------- | ----- | ------------ | ---- |
228
| level | num | 当前等级 | |
229
| color | num | 等级框颜色 | |
230
| current | array | 当前等级信息 | |
231
| next | array | 下一等级信息 | |
232
233
`master_level`中的`current`数组：
234
235
| 项 | 类型 | 内容 | 备注 |
236
| ---- | ---- | -------- | ---- |
237
| 0 | num | 升级积分 | |
238
| 1 | num | 总积分 | |
239
240
`master_level`中的`next`数组：
241
242
| 项 | 类型 | 内容 | 备注 |
243
| ---- | ---- | -------- | ---- |
244
| 0 | num | 升级积分 | |
245
| 1 | num | 总积分 | |
246
247
`room_news`对象：
248
249
| 字段 | 类型 | 内容 | 备注 |
250
| ---------- | ---- | -------- | ---- |
251
| content | str | 公告内容 | |
252
| ctime | str | 公告时间 | |
253
| ctime_text | str | 公告日期 | |
254
255
**示例：**
256
257
查询直播间`UID=76`的主播信息
258
259
```shell
260
curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
261
--data-urlencode 'uid=2'
262
```
263
264
<details>
265
<summary>查看响应示例：</summary>
266
267
```json
268
{
269
"code": 0,
270
"msg": "",
271
"message": "",
272
"data": {
273
"info": {
274
"uid": 2,
275
"uname": "碧诗",
276
"face": "https://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
277
"official_verify": {
278
"type": 0,
279
"desc": "bilibili个人认证:bilibili创始人（站长）"
280
},
281
"gender": 1
282
},
283
"exp": {
284
"master_level": {
285
"level": 30,
286
"color": 10512625,
287
"current": [
288
2870000,
289
11883810
290
],
291
"next": [
292
3730000,
293
15613810
294
]
295
}
296
},
297
"follower_num": 926624,
298
"room_id": 1024,
299
"medal_name": "逸国",
300
"glory_count": 0,
301
"pendant": "",
302
"link_group_num": 0,
303
"room_news": {
304
"content": "",
305
"ctime": "",
306
"ctime_text": ""
307
}
308
}
309
}
310
```
311
312
</details>