返回提交历史
Modified
live/info.md
+49
-40
XFEstudio/bilibili-API-collect
update: 新增GET方式批量查询直播间状态接口 (#359)
* feat: 添加批量查询直播间状态接口 * update: 新增GET方式批量查询直播间状态接口 * fix format Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
bb437d2
代码差异
1 个文件
+49
-40
@@ -317,16 +317,21 @@ curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
317
317
318
318
> http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids
319
319
320
*请求方式：POST*
320
*请求方式：GET/POST*
321
321
322
认证方式：无，请不要在标头中添加cookie。
322
认证方式：无 (无需添加Cookie)
323
323
324
**url参数 (GET方式)：**
324
325
325
**正文参数：**
326
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
327
| ------ | ----- | ---------------- | ------ | ---- |
328
| uids[] | array | 要查询的主播 mid | 必要 | |
329
330
**正文参数 (POST方式)：**
326
331
327
332
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
328
333
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
329
| uids | array | 要查询的主播mid | 必要 | |
334
| uids | nums | 要查询的主播 mid | 必要 | |
330
335
331
336
332
337
**json回复：**
@@ -357,12 +362,12 @@ curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
357
362
| area_v2_name | str | 直播间新版分区名 | |
358
363
| area_v2_parent_id | num | 直播间父分区id | |
359
364
| area_v2_parent_name | str | 直播间父分区名 | |
360
| broadcast_type | num | 直播类型 | 0:普通直播，1：手机直播 |
365
| broadcast_type | num | 直播类型 | 0:普通直播<br />1：手机直播 |
361
366
| cover_from_user | str | 直播间封面url | |
362
367
| face | str | 主播头像url | |
363
368
| hidden_till | str | 直播间隐藏信息 | |
364
369
| keyframe | str | 直播间关键帧url | |
365
| live_status | num | 直播间开播状态 | 0：未开播，1：正在直播，2：轮播中 |
370
| live_status | num | 直播间开播状态 | 0：未开播<br />1：正在直播<br />2：轮播中 |
366
371
| live_time | num | 直播持续时长 | |
367
372
| lock_till | str | 直播间封禁信息 | |
368
373
| online | num | 直播间在线人数 | |
@@ -376,12 +381,17 @@ curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
376
381
377
382
**示例：**
378
383
379
查询用户`mid=194484313`的直播间信息
384
查询用户`mid=672328094的直播间信息
380
385
381
386
```shell
382
curl https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids \
387
# GET方式
388
curl -G 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids'
389
--data-urlencode 'uids[]=672328094'
390
391
# POST方式
392
curl 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids' \
383
393
-H "Content-Type: application/json" \
384
-d "{\"uids\": [194484313]}"
394
-d "{\"uids\": [672328094]}"
385
395
```
386
396
387
397
<details>
@@ -389,37 +399,36 @@ curl https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids \
389
399
390
400
```json
391
401
{
392
"code": 0,
393
"msg": "success",
394
"message": "success",
395
"data": {
396
"194484313": {
397
"title": "中元节可爱鬼来喽！",
398
"room_id": 6154037,
399
"uid": 194484313,
400
"online": 955261,
401
"live_time": 0,
402
"live_status": 2,
403
"short_id": 732,
404
"area": 1,
405
"area_name": "单机联机",
406
"area_v2_id": 236,
407
"area_v2_name": "主机游戏",
408
"area_v2_parent_name": "单机游戏",
409
"area_v2_parent_id": 6,
410
"uname": "Asaki大人",
411
"face": "https://i1.hdslb.com/bfs/face/e8f57fd6992f7d2ef6e6bcee957fb6cf6bca3d80.jpg",
412
"tag_name": "以撒,minecraft,饥荒,彩虹六号,东方",
413
"tags": "",
414
"cover_from_user": "https://i0.hdslb.com/bfs/live/new_room_cover/0a0a8eb5bd7fb64a036b55c748f02ad79a210ec9.jpg",
415
"keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe0823020500000615403721k8sp.jpg",
416
"lock_till": "0000-00-00 00:00:00",
417
"hidden_till": "0000-00-00 00:00:00",
418
"broadcast_type": 0
419
}
420
}
402
"code": 0,
403
"msg": "success",
404
"message": "success",
405
"data": {
406
"672328094": {
407
"title": "【B限】玩个毛线",
408
"room_id": 22637261,
409
"uid": 672328094,
410
"online": 4087370,
411
"live_time": 0,
412
"live_status": 2,
413
"short_id": 0,
414
"area": 6,
415
"area_name": "生活娱乐",
416
"area_v2_id": 371,
417
"area_v2_name": "虚拟主播",
418
"area_v2_parent_name": "虚拟主播",
419
"area_v2_parent_id": 9,
420
"uname": "嘉然今天吃什么",
421
"face": "http://i2.hdslb.com/bfs/face/d399d6f5cf7943a996ae96999ba3e6ae2a2988de.jpg",
422
"tag_name": "日常,学习,萌宠,厨艺,手机直播",
423
"tags": "",
424
"cover_from_user": "http://i0.hdslb.com/bfs/live/new_room_cover/f3ed7a782c13086e536ec8bc6e9593bb4918f905.jpg",
425
"keyframe": "http://i0.hdslb.com/bfs/live-key-frame/keyframe041722000000226372619dr3m8.jpg",
426
"lock_till": "0000-00-00 00:00:00",
427
"hidden_till": "0000-00-00 00:00:00",
428
"broadcast_type": 0
429
}
430
}
421
431
}
422
423
432
```
424
433
425
</details>
434
</details>