mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-28 13:30:08 +08:00
215 lines
6.8 KiB
Markdown
215 lines
6.8 KiB
Markdown
# 直播间分区
|
||
|
||
- [获取全部直播间分区列表](#获取全部直播间分区列表)
|
||
|
||
---
|
||
|
||
## 获取全部直播间分区列表
|
||
|
||
> https://api.live.bilibili.com/room/v1/Area/getList
|
||
|
||
*请求方式：GET*
|
||
|
||
直播分区共有两级，分别是父分区和子分区
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ------ | ---------- | ------------- |
|
||
| code | num | 返回值 | 0：成功 |
|
||
| msg | str | 错误信息 | 默认为success |
|
||
| message | str | 错误信息 | 默认为success |
|
||
| data | array | 父分区列表 | |
|
||
|
||
`data`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ----------- | ---- |
|
||
| 0 | obj | 父分区1 | |
|
||
| n | obj | 父分区(n+1) | |
|
||
| …… | obj | …… | …… |
|
||
|
||
`data`数组中的对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ---------- | ---- |
|
||
| id | num | 父分区id | |
|
||
| name | name | 父分区名 | |
|
||
| list | list | 子分区列表 | |
|
||
|
||
`data`数组中的对象中的`list`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ----------- | ---- |
|
||
| 0 | obj | 子分区1 | |
|
||
| n | obj | 子分区(n+1) | |
|
||
| …… | obj | …… | …… |
|
||
|
||
`list`数组中的对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------- | ---- | ----------------- | ---------------- |
|
||
| id | str | 子分区id | |
|
||
| parent_id | str | 父分区id | |
|
||
| old_area_id | str | 旧分区id | |
|
||
| name | str | 子分区名 | |
|
||
| act_id | str | 0 | **作用尚不明确** |
|
||
| pk_status | str | ？？？ | **作用尚不明确** |
|
||
| hot_status | num | 是否为热门分区 | 0：否<br />1：是 |
|
||
| lock_status | str | 0 | **作用尚不明确** |
|
||
| pic | str | 子分区标志图片url | |
|
||
| parent_name | str | 父分区名 | |
|
||
| area_type | num | | |
|
||
|
||
**示例：**
|
||
|
||
如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区id为`86`
|
||
|
||
```shell
|
||
curl 'https://api.live.bilibili.com/room/v1/Area/getList'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"message": "success",
|
||
"data": [
|
||
{
|
||
"id": 2,
|
||
"name": "网游",
|
||
"list": [
|
||
{
|
||
"id": "86",
|
||
"parent_id": "2",
|
||
"old_area_id": "4",
|
||
"name": "英雄联盟",
|
||
"act_id": "0",
|
||
"pk_status": "0",
|
||
"hot_status": 1,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/dcfb14f14ec83e503147a262e7607858b05d7ac0.png",
|
||
"parent_name": "网游",
|
||
"area_type": 0
|
||
},
|
||
{
|
||
"id": "252",
|
||
"parent_id": "2",
|
||
"old_area_id": "3",
|
||
"name": "逃离塔科夫",
|
||
"act_id": "0",
|
||
"pk_status": "0",
|
||
"hot_status": 1,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/762a7de3dd5fe8165d1d55b232484a017941592f.png",
|
||
"parent_name": "网游",
|
||
"area_type": 0
|
||
},
|
||
{
|
||
"id": "80",
|
||
"parent_id": "2",
|
||
"old_area_id": "1",
|
||
"name": "绝地求生",
|
||
"act_id": "0",
|
||
"pk_status": "0",
|
||
"hot_status": 1,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/43ca83fdcd10505eaeef1b76cf8ce642a53b94da.png",
|
||
"parent_name": "网游",
|
||
"area_type": 0
|
||
},
|
||
…………
|
||
]
|
||
},
|
||
{
|
||
"id": 3,
|
||
"name": "手游",
|
||
"list": [
|
||
{
|
||
"id": "35",
|
||
"parent_id": "3",
|
||
"old_area_id": "12",
|
||
"name": "王者荣耀",
|
||
"act_id": "0",
|
||
"pk_status": "0",
|
||
"hot_status": 1,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/0fefa924760b2dd492a12dddafe179bfa1216918.png",
|
||
"parent_name": "手游",
|
||
"area_type": 0
|
||
},
|
||
…………
|
||
]
|
||
},
|
||
{
|
||
"id": 6,
|
||
"name": "单机",
|
||
"list": [
|
||
{
|
||
"id": "236",
|
||
"parent_id": "6",
|
||
"old_area_id": "1",
|
||
"name": "主机游戏",
|
||
"act_id": "0",
|
||
"pk_status": "0",
|
||
"hot_status": 1,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/edb636ee59f902e3134a2790545045bddd70978e.png",
|
||
"parent_name": "单机",
|
||
"area_type": 0
|
||
},
|
||
…………
|
||
]
|
||
},
|
||
{
|
||
"id": 1,
|
||
"name": "娱乐",
|
||
"list": [
|
||
{
|
||
"id": "21",
|
||
"parent_id": "1",
|
||
"old_area_id": "10",
|
||
"name": "视频唱见",
|
||
"act_id": "0",
|
||
"pk_status": "1",
|
||
"hot_status": 1,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/72b93ddafdf63c9f0b626ad546847a3c03c92b6f.png",
|
||
"cate_id": "12",
|
||
"parent_name": "娱乐",
|
||
"area_type": 0
|
||
},
|
||
…………
|
||
]
|
||
},
|
||
{
|
||
"id": 5,
|
||
"name": "电台",
|
||
"list": [
|
||
{
|
||
"id": "190",
|
||
"parent_id": "5",
|
||
"old_area_id": "10",
|
||
"name": "唱见电台",
|
||
"act_id": "0",
|
||
"pk_status": "0",
|
||
"hot_status": 0,
|
||
"lock_status": "0",
|
||
"pic": "http://i0.hdslb.com/bfs/vc/d22d7fafbf9b24e2bc3ce1df5eb9f006e6035e5d.png",
|
||
"parent_name": "电台",
|
||
"area_type": 0
|
||
},
|
||
…………
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
</details>
|