返回提交历史
Modified
live/info.md
+203
-1
XFEstudio/bilibili-API-collect
添加 获取直播间信息 API (#452)
340646b
代码差异
1 个文件
+203
-1
@@ -1,6 +1,7 @@
1
1
# 直播间基本信息
2
2
3
3
- [直播间基本信息](#直播间基本信息)
4
- [获取直播间信息](#获取直播间信息)
4
5
- [获取用户对应的直播间状态](#获取用户对应的直播间状态)
5
6
- [获取房间页初始化信息](#获取房间页初始化信息)
6
7
- [获取主播信息](#获取主播信息)
@@ -8,6 +9,207 @@
8
9
9
10
---
10
11
12
## 获取直播间信息
13
14
> http://api.live.bilibili.com/room/v1/Room/get_info
15
16
*请求方式: GET*
17
18
**URL参数：**
19
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
20
| ------ | ---- | ----------- | ----- | --------- |
21
| room_id| num | 直播间号 | 必要 | 可以为短号 |
22
23
**json回复：**
24
25
根对象：
26
| 字段 | 类型 | 内容 | 备注 |
27
| ------- | ---- | -------- | --------------------------- |
28
| code | num | 返回值 | 0：成功<br />1：不存在 |
29
| message | str | 错误信息 | |
30
| msg | str | 错误信息 | |
31
| data | obj | 信息本体 | |
32
33
`data`对象：
34
| 字段 | 类型 | 内容 | 备注 |
35
| ------------------ | ---- | -------- | --------------------------- |
36
| uid | num | 主播mid | |
37
| room_id | num | 直播间长号| |
38
| short_id | num | 直播间短号| 为0是无短号 |
39
| attention | num | 关注数量 | |
40
| online | num | 观看人数 | |
41
| is_portrait | bool | 是否竖屏 | |
42
| description | str | 描述 | |
43
| liveStatus | num | 直播状态 | 0：未开播<br />1：直播中<br />2：轮播中 |
44
| area_id | num | 分区id | |
45
| area_name | str | 分区名称 | |
46
| parent_area_id | num | 父分区id | |
47
| parent_area_name | str | 父分区名称 | |
48
| old_area_id | num | 旧版分区id | |
49
| background | str | 背景图片链接| |
50
| title | str | 标题 | |
51
| user_cover | str | 封面 | |
52
| keyframe | str | 关键帧 | 用于网页端悬浮展示 |
53
| is_strict_room | bool | 未知 | 未知 |
54
| live_time | str | 直播开始时间 | YYYY-MM-DD HH:mm:ss |
55
| tags | str | 标签 | ','分隔 |
56
| is_anchor | num | 未知 | 未知 |
57
| room_silent_type | str | 禁言状态 | |
58
| room_silent_level | num | 禁言等级 | |
59
| room_silent_second | num | 禁言时间 | 单位是秒 |
60
| pardants | str | 未知 | 未知 |
61
| area_pardants | str | 未知 | 未知 |
62
| hot_words | list(str) | 热词 | |
63
| hot_words_status | num | 热词状态 | |
64
| verify | str | 未知 | 未知 |
65
| new_pendants | obj | 头像框\大v | |
66
| up_session | str | 未知 | |
67
| pk_status | num | pk状态 | |
68
| pk_id | num | pk id | |
69
| battle_id | num | 未知 | |
70
71
`new_pendants`对象：
72
| 字段 | 类型 | 内容 | 备注 |
73
| ------------ | ---- | -------- | --------------------------- |
74
| frame | obj | 头像框 | |
75
| mobile_frame | obj | 同上 | 手机版, 结构一致, 可能null |
76
| badge | obj | 大v | |
77
| mobile_badge | obj | 同上 | 手机版, 结构一致, 可能null |
78
79
`frame`对象：
80
| 字段 | 类型 | 内容 | 备注 |
81
| ------------ | ---- | -------- | --------------------------- |
82
| name | str | 名称 ||
83
| value | str | 值 ||
84
| position | num | 位置 ||
85
| desc | str | 描述 ||
86
| area | num | 分区 ||
87
| area_old | num | 旧分区 ||
88
| bg_color | str | 背景色 ||
89
| bg_pic | str | 背景图 ||
90
| use_old_area | bool | 是否旧分区号 ||
91
92
`badge`对象：
93
| 字段 | 类型 | 内容 | 备注 |
94
| ------------ | ---- | -------- | --------------------------- |
95
| name | str | 类型 | v_person: 个人认证(黄) <br> v_company: 企业认证(蓝) |
96
| position | num | 位置 ||
97
| value | str | 值 ||
98
| desc | str | 描述 ||
99
100
**示例：**
101
102
查询直播间`room_id=1`信息
103
104
```shell
105
curl -G 'http://api.live.bilibili.com/room/v1/Room/get_info' \
106
--data-urlencode 'room_id=1'
107
```
108
109
<details>
110
<summary>查看响应示例：</summary>
111
112
```json
113
{
114
"code": 0,
115
"msg": "ok",
116
"message": "ok",
117
"data": {
118
"uid": 9617619,
119
"room_id": 5440,
120
"short_id": 1,
121
"attention": 11919499,
122
"online": 0,
123
"is_portrait": false,
124
"description": "欢迎加入bilibili《快乐运动研究社》，和B站UP主们一起探讨有关运动的经历感受，解决身体和情绪的“疑难杂症”，寻找适合自己的运动，一起跟练！本期我们一起探讨：运动健身能缓解社交恐惧吗？",
125
"live_status": 2,
126
"area_id": 145,
127
"parent_area_id": 1,
128
"parent_area_name": "娱乐",
129
"old_area_id": 6,
130
"background": "",
131
"title": "快乐运动研究社",
132
"user_cover": "https://i0.hdslb.com/bfs/live/new_room_cover/96943b8d106a777a34cf796421bb4254163b30e1.jpg",
133
"keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe08121926000000005440np0q7a.jpg",
134
"is_strict_room": false,
135
"live_time": "0000-00-00 00:00:00",
136
"tags": "",
137
"is_anchor": 0,
138
"room_silent_type": "",
139
"room_silent_level": 1,
140
"room_silent_second": 0,
141
"area_name": "视频聊天",
142
"pendants": "",
143
"area_pendants": "",
144
"hot_words": [
145
"2333333",
146
"喂，妖妖零吗",
147
"红红火火恍恍惚惚",
148
"FFFFFFFFFF",
149
"Yooooooo",
150
"啪啪啪啪啪",
151
"666666666",
152
"老司机带带我",
153
"你为什么这么熟练啊",
154
"gg",
155
"prprpr",
156
"向大佬低头",
157
"请大家注意弹幕礼仪哦！",
158
"还有这种操作！",
159
"囍",
160
"打call",
161
"你气不气？",
162
"队友呢？"
163
],
164
"hot_words_status": 0,
165
"verify": "",
166
"new_pendants": {
167
"frame": {
168
"name": "",
169
"value": "",
170
"position": 0,
171
"desc": "",
172
"area": 0,
173
"area_old": 0,
174
"bg_color": "",
175
"bg_pic": "",
176
"use_old_area": false
177
},
178
"badge": {
179
"name": "v_company",
180
"position": 3,
181
"value": "",
182
"desc": "哔哩哔哩直播官方账号"
183
},
184
"mobile_frame": {
185
"name": "",
186
"value": "",
187
"position": 0,
188
"desc": "",
189
"area": 0,
190
"area_old": 0,
191
"bg_color": "",
192
"bg_pic": "",
193
"use_old_area": false
194
},
195
"mobile_badge": null
196
},
197
"up_session": "",
198
"pk_status": 0,
199
"pk_id": 0,
200
"battle_id": 0,
201
"allow_change_area_time": 0,
202
"allow_upload_cover_time": 0,
203
"studio_info": {
204
"status": 0,
205
"master_list": []
206
}
207
}
208
}
209
```
210
211
</details>
212
11
213
## 获取用户对应的直播间状态
12
214
13
215
> https://api.live.bilibili.com/room/v1/Room/getRoomInfoOld
@@ -431,4 +633,4 @@ curl 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids' \
431
633
}
432
634
```
433
635
434
</details>
636
</details>