mirrors/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fffb2dda40edcd203efaa339c3cbdaf77bd04633
bilibili-API-collect/live/info.md
T

637 lines
22 KiB
Markdown
Raw Normal View History

添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
# 直播间基本信息
https统一写作http (#288)
2021-12-17 10:26:13 +08:00
- [直播间基本信息](#直播间基本信息)
修正了直播间基本信息的字段错误 (#492)
2022-09-23 15:58:51 +01:00
- [获取直播间信息](#获取直播间信息)
- [获取用户对应的直播间状态](#获取用户对应的直播间状态)
- [获取房间页初始化信息](#获取房间页初始化信息)
- [获取主播信息](#获取主播信息)
- [批量查询直播间状态](#批量查询直播间状态)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
---
添加 获取直播间信息 API (#452)
2022-08-24 23:34:45 +08:00
## 获取直播间信息
> http://api.live.bilibili.com/room/v1/Room/get_info
*请求方式: GET*
**URL参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ----- | --------- |
| room_id| num | 直播间号 | 必要 | 可以为短号 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />1：不存在 |
| message | str | 错误信息 | |
| msg | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ---- | -------- | --------------------------- |
| uid | num | 主播mid | |
| room_id | num | 直播间长号| |
| short_id | num | 直播间短号| 为0是无短号 |
| attention | num | 关注数量 | |
| online | num | 观看人数 | |
| is_portrait | bool | 是否竖屏 | |
| description | str | 描述 | |
修正了直播间基本信息的字段错误 (#492)
2022-09-23 15:58:51 +01:00
| live_status | num | 直播状态 | 0：未开播<br />1：直播中<br />2：轮播中 |
添加 获取直播间信息 API (#452)
2022-08-24 23:34:45 +08:00
| area_id | num | 分区id | |
| area_name | str | 分区名称 | |
| parent_area_id | num | 父分区id | |
| parent_area_name | str | 父分区名称 | |
| old_area_id | num | 旧版分区id | |
| background | str | 背景图片链接| |
| title | str | 标题 | |
| user_cover | str | 封面 | |
| keyframe | str | 关键帧 | 用于网页端悬浮展示 |
| is_strict_room | bool | 未知 | 未知 |
| live_time | str | 直播开始时间 | YYYY-MM-DD HH:mm:ss |
| tags | str | 标签 | ','分隔 |
| is_anchor | num | 未知 | 未知 |
| room_silent_type | str | 禁言状态 | |
| room_silent_level | num | 禁言等级 | |
| room_silent_second | num | 禁言时间 | 单位是秒 |
| pardants | str | 未知 | 未知 |
| area_pardants | str | 未知 | 未知 |
| hot_words | list(str) | 热词 | |
| hot_words_status | num | 热词状态 | |
| verify | str | 未知 | 未知 |
| new_pendants | obj | 头像框\大v | |
| up_session | str | 未知 | |
| pk_status | num | pk状态 | |
| pk_id | num | pk id | |
| battle_id | num | 未知 | |
`new_pendants`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | -------- | --------------------------- |
| frame | obj | 头像框 | |
| mobile_frame | obj | 同上 | 手机版, 结构一致, 可能null |
| badge | obj | 大v | |
| mobile_badge | obj | 同上 | 手机版, 结构一致, 可能null |
`frame`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | -------- | --------------------------- |
| name | str | 名称 ||
| value | str | 值 ||
| position | num | 位置 ||
| desc | str | 描述 ||
| area | num | 分区 ||
| area_old | num | 旧分区 ||
| bg_color | str | 背景色 ||
| bg_pic | str | 背景图 ||
| use_old_area | bool | 是否旧分区号 ||
`badge`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | -------- | --------------------------- |
| name | str | 类型 | v_person: 个人认证(黄) <br> v_company: 企业认证(蓝) |
| position | num | 位置 ||
| value | str | 值 ||
| desc | str | 描述 ||
**示例：**
查询直播间`room_id=1`信息
```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/get_info' \
--data-urlencode 'room_id=1'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "ok",
"message": "ok",
"data": {
"uid": 9617619,
"room_id": 5440,
"short_id": 1,
"attention": 11919499,
"online": 0,
"is_portrait": false,
"description": "欢迎加入bilibili《快乐运动研究社》，和B站UP主们一起探讨有关运动的经历感受，解决身体和情绪的“疑难杂症”，寻找适合自己的运动，一起跟练！本期我们一起探讨：运动健身能缓解社交恐惧吗？",
"live_status": 2,
"area_id": 145,
"parent_area_id": 1,
"parent_area_name": "娱乐",
"old_area_id": 6,
"background": "",
"title": "快乐运动研究社",
"user_cover": "https://i0.hdslb.com/bfs/live/new_room_cover/96943b8d106a777a34cf796421bb4254163b30e1.jpg",
"keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe08121926000000005440np0q7a.jpg",
"is_strict_room": false,
"live_time": "0000-00-00 00:00:00",
"tags": "",
"is_anchor": 0,
"room_silent_type": "",
"room_silent_level": 1,
"room_silent_second": 0,
"area_name": "视频聊天",
"pendants": "",
"area_pendants": "",
"hot_words": [
"2333333",
"喂，妖妖零吗",
"红红火火恍恍惚惚",
"FFFFFFFFFF",
"Yooooooo",
"啪啪啪啪啪",
"666666666",
"老司机带带我",
"你为什么这么熟练啊",
"gg",
"prprpr",
"向大佬低头",
"请大家注意弹幕礼仪哦！",
"还有这种操作！",
"囍",
"打call",
"你气不气？",
"队友呢？"
],
"hot_words_status": 0,
"verify": "",
"new_pendants": {
"frame": {
"name": "",
"value": "",
"position": 0,
"desc": "",
"area": 0,
"area_old": 0,
"bg_color": "",
"bg_pic": "",
"use_old_area": false
},
"badge": {
"name": "v_company",
"position": 3,
"value": "",
"desc": "哔哩哔哩直播官方账号"
},
"mobile_frame": {
"name": "",
"value": "",
"position": 0,
"desc": "",
"area": 0,
"area_old": 0,
"bg_color": "",
"bg_pic": "",
"use_old_area": false
},
"mobile_badge": null
},
"up_session": "",
"pk_status": 0,
"pk_id": 0,
"battle_id": 0,
"allow_change_area_time": 0,
"allow_upload_cover_time": 0,
"studio_info": {
"status": 0,
"master_list": []
}
}
}
```
</details>
优化文档格式
2020-06-08 22:44:46 +08:00
## 获取用户对应的直播间状态
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
fix: wrong live api scheme (#446)
2022-08-24 23:27:11 +08:00
> https://api.live.bilibili.com/room/v1/Room/getRoomInfoOld
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
优化文档格式
2020-06-08 22:44:46 +08:00
**url参数：**
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 目标用户mid | 必要 | |
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
| data | obj | 信息本体 | |
`data`对象：
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ |
| roomStatus | num | 直播间状态 | 0：无房间<br />1：有房间 |
| roundStatus | num | 轮播状态 | 0：未轮播<br />1：轮播 |
字段更新 (#462)
2022-08-30 15:00:28 +08:00
| live_status | num | 直播状态 | 0：未开播<br />1：直播中 |
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| url | str | 直播间网页url | |
| title | str | 直播间标题 | |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| roomid | num | 直播间id（短号） | |
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| broadcast_type | num | 0 | |
| online_hidden | num | 0 | |
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
查询用户`mid=322892`的直播间信息
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
--data-urlencode 'mid=322892'
```
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"roomStatus": 1,
"roundStatus": 0,
字段更新 (#462)
2022-08-30 15:00:28 +08:00
"live_status": 1,
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
"url": "https://live.bilibili.com/5441",
"title": "好久没当黑铁主播了",
"cover": "http://i0.hdslb.com/bfs/live/room_cover/833f7ff506bac17c06010e8834922993657505b2.jpg",
"online": 268602,
"roomid": 5441,
"broadcast_type": 0,
"online_hidden": 0
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
完善直播间信息API
2020-10-11 18:04:32 +08:00
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
## 获取房间页初始化信息
完善直播间信息API
2020-10-11 18:04:32 +08:00
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
> http://api.live.bilibili.com/room/v1/Room/room_init
完善直播间信息API
2020-10-11 18:04:32 +08:00
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| id | num | 目标直播间号（短号） | 必要 | |
完善直播间信息API
2020-10-11 18:04:32 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />60004：直播间不存在 |
| msg | str | 错误信息 | 默认为ok |
| message | str | 错误信息 | 默认为ok |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------------- | ------------------------ |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| room_id | num | 直播间真实id | |
| short_id | num | 直播间id（短号） | |
| uid | num | 主播用户mid | |
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| need_p2p | num | 是否p2p | |
| is_hidden | bool | 是否隐藏 | |
| is_locked | bool | 是否锁定 | |
| is_portrait | bool | 是否竖屏 | |
Update info.md (#124)
2021-01-05 12:09:22 +08:00
| live_status | num | 直播状态 | 0：未开播<br />1：直播中<br />2：轮播中 |
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| hidden_till | num | 隐藏时间戳 | |
| lock_till | num | 锁定时间戳 | |
| encrypted | bool | 是否加密 | |
| pwd_verified | bool | 加密房间是否通过密码验证 | `encrypted`=true时才有意义 |
Update info.md (#124)
2021-01-05 12:09:22 +08:00
| live_time | num | 开播时间 | 未开播时为`-62170012800` |
完善直播间信息API
2020-10-11 18:04:32 +08:00
| room_shield | num | 未知 | |
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
| is_sp | num | 是否为特殊直播间 | 0：普通直播间<br />1：付费直播间 |
| special_type | num | 特殊直播间标志 | 0：普通直播间<br />1：付费直播间<br />2：拜年祭直播间 |
完善直播间信息API
2020-10-11 18:04:32 +08:00
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
查询直播间`id=76`的直播间信息
完善直播间信息API
2020-10-11 18:04:32 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
完善直播间信息API
2020-10-11 18:04:32 +08:00
--data-urlencode 'id=76'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code":0,
"msg":"ok",
"message":"ok",
"data":{
"room_id":14073662,
"short_id":76,
"uid":50333369,
"need_p2p":0,
"is_hidden":false,
"is_locked":false,
"is_portrait":false,
"live_status":1,
"hidden_till":0,
"lock_till":0,
"encrypted":false,
"pwd_verified":false,
"live_time":1602151186,
"room_shield":1,
"is_sp":0,
"special_type":0
}
}
```
勘误
2020-10-11 18:07:00 +08:00
</details>
Update info.md (#132)
2021-01-17 12:43:54 +08:00
## 获取主播信息
> http://api.live.bilibili.com/live_user/v1/Master/info
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| uid | num | 目标用户mid | 必要 | |
Update info.md (#132)
2021-01-17 12:43:54 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------ |
| code | num | 返回值 | 0：成功<br />1：参数错误 |
| msg | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为空 |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ---------------- |
| info | obj | 主播信息 | |
| exp | obj | 经验等级 | |
| follower_num | num | 主播粉丝数 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| room_id | num | 直播间id（短号） | |
Update info.md (#132)
2021-01-17 12:43:54 +08:00
| medal_name | str | 粉丝勋章名 | |
添加：剧集时间轴，修改：统一int至num (#374)
2022-05-26 11:38:35 +08:00
| glory_count | num | 主播荣誉数 | |
Update info.md (#132)
2021-01-17 12:43:54 +08:00
| pendant | str | 直播间头像框url | |
添加：剧集时间轴，修改：统一int至num (#374)
2022-05-26 11:38:35 +08:00
| link_group_num | num | 0 | **作用尚不明确** |
Update info.md (#132)
2021-01-17 12:43:54 +08:00
| room_news | obj | 主播公告 | |
`info`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ------------------------------ |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| uid | num | 主播mid | |
Update info.md (#132)
2021-01-17 12:43:54 +08:00
| uname | str | 主播用户名 | |
| face | str | 主播头像url | |
| official_verify | obj | 认证信息 | |
| gender | num | 主播性别 | -1：保密<br />0：女<br />1：男 |
`info`中的`official_verify`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---------------------------------------- |
| type | num | 主播认证类型 | -1：无<br />0：个人认证<br />1：机构认证 |
| desc | str | 主播认证信息 | |
`exp`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | -------- | ---- |
| master_level | obj | 主播等级 | |
`exp`中的`master_level`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | ------------ | ---- |
| level | num | 当前等级 | |
| color | num | 等级框颜色 | |
| current | array | 当前等级信息 | |
| next | array | 下一等级信息 | |
`master_level`中的`current`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| 0 | num | 升级积分 | |
| 1 | num | 总积分 | |
`master_level`中的`next`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| 0 | num | 升级积分 | |
| 1 | num | 总积分 | |
`room_news`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------- | ---- |
| content | str | 公告内容 | |
| ctime | str | 公告时间 | |
| ctime_text | str | 公告日期 | |
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
查询直播间`mid=76`的主播信息
Update info.md (#132)
2021-01-17 12:43:54 +08:00
```shell
curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
--data-urlencode 'uid=2'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "",
"message": "",
"data": {
"info": {
"uid": 2,
"uname": "碧诗",
"face": "https://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"official_verify": {
"type": 0,
"desc": "bilibili个人认证:bilibili创始人（站长）"
},
"gender": 1
},
"exp": {
"master_level": {
"level": 30,
"color": 10512625,
"current": [
2870000,
11883810
],
"next": [
3730000,
15613810
]
}
},
"follower_num": 926624,
"room_id": 1024,
"medal_name": "逸国",
"glory_count": 0,
"pendant": "",
"link_group_num": 0,
"room_news": {
"content": "",
"ctime": "",
"ctime_text": ""
}
}
}
```
</details>
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
## 批量查询直播间状态
https统一写作http (#288)
2021-12-17 10:26:13 +08:00
> http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
*请求方式：GET/POST*
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
认证方式：无 (无需添加Cookie)
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
**url参数 (GET方式)：**
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ----- | ---------------- | ------ | ---- |
| uids[] | array | 要查询的主播 mid | 必要 | |
**正文参数 (POST方式)：**
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
| uids | nums | 要查询的主播 mid | 必要 | |
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败 |
| message | str | 错误信息 | 默认为success |
| msg | str | 错误信息 | 默认为success |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------ |
| uid | str | 直播间信息 | 实际字段为主播mid |
`uid`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------ |
| area | num | 直播间分区id | |
| area_name | str | 直播间分区名 | |
| area_v2_id | num | 直播间新版分区id | |
| area_v2_name | str | 直播间新版分区名 | |
| area_v2_parent_id | num | 直播间父分区id | |
| area_v2_parent_name | str | 直播间父分区名 | |
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
| broadcast_type | num | 直播类型 | 0:普通直播<br />1：手机直播 |
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
| cover_from_user | str | 直播间封面url | |
| face | str | 主播头像url | |
| hidden_till | str | 直播间隐藏信息 | |
| keyframe | str | 直播间关键帧url | |
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
| live_status | num | 直播间开播状态 | 0：未开播<br />1：正在直播<br />2：轮播中 |
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
| live_time | num | 直播持续时长 | |
| lock_till | str | 直播间封禁信息 | |
| online | num | 直播间在线人数 | |
| room_id | num | 直播间房间号 | 直播间实际房间号 |
| short_id | num | 直播间房间号 | 直播间短房间号，常见于签约主播 |
| tag_name | str | 直播间标签 | |
| tags | str | 直播间自定标签 | |
| title | str | 直播间标题 | |
| uid | num | 主播mid | |
| uname | str | 主播用户名 | |
**示例：**
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
查询用户`mid=672328094的直播间信息
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
```shell
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
# GET方式
curl -G 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids'
--data-urlencode 'uids[]=672328094'
# POST方式
curl 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids' \
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
-H "Content-Type: application/json" \
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
-d "{\"uids\": [672328094]}"
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
```
<details>
<summary>查看响应示例：</summary>
```json
{
update: 新增GET方式批量查询直播间状态接口 (#359)
2022-04-18 21:27:55 +08:00
"code": 0,
"msg": "success",
"message": "success",
"data": {
"672328094": {
"title": "【B限】玩个毛线",
"room_id": 22637261,
"uid": 672328094,
"online": 4087370,
"live_time": 0,
"live_status": 2,
"short_id": 0,
"area": 6,
"area_name": "生活娱乐",
"area_v2_id": 371,
"area_v2_name": "虚拟主播",
"area_v2_parent_name": "虚拟主播",
"area_v2_parent_id": 9,
"uname": "嘉然今天吃什么",
"face": "http://i2.hdslb.com/bfs/face/d399d6f5cf7943a996ae96999ba3e6ae2a2988de.jpg",
"tag_name": "日常,学习,萌宠,厨艺,手机直播",
"tags": "",
"cover_from_user": "http://i0.hdslb.com/bfs/live/new_room_cover/f3ed7a782c13086e536ec8bc6e9593bb4918f905.jpg",
"keyframe": "http://i0.hdslb.com/bfs/live-key-frame/keyframe041722000000226372619dr3m8.jpg",
"lock_till": "0000-00-00 00:00:00",
"hidden_till": "0000-00-00 00:00:00",
"broadcast_type": 0
}
}
新增批量查询直播间API (#228)
2021-08-25 02:29:24 +10:00
}
```
添加 获取直播间信息 API (#452)
2022-08-24 23:34:45 +08:00
</details>
Reference in New Issue Copy Permalink