# 获取地区直播区列表数据
# 适用应用类型
- 通用
# 接口地址
https://open-api.ybsjyyn.com/api/yynbusi/region/live?access_token=[ACCESS_TOKEN]&city_id=[CITY_ID]&district_id=[DISTRICT_ID]&context=[CONTEXT]&size=[SIZE]
# 请求方式
GET
# 请求参数
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
access_token | string | 是 | 业务接口调用凭证 |
city_id | string | 是 | 能力授权绑定的州市id,已授权能力处查看 |
district_id | string | 是 | 能力授权绑定的区县id,已授权能力处查看,如果授权是全部则传'all' |
context | string | 否 | 分页信息,首页不传,后续传上一页返回内容 |
size | string | 否 | 每页数量 |
# 返回参数
WARNING
可能存在返回的数据结构中不包含以下某个字段——这说明该字段属于非必需字段。游云南内部在建立数据时未填写该字段,所以业务数据库未存储该字段。
请求接口时,返回满足以下条件的慢直播流
- 在线状态
- 运营状态是启用状态
- 推流时间至今大于15分钟
- 夜间时,根据直播属性,不适合夜间展示的切为视频垫片;适合夜间展示的正常使用直播流
参数名称 | 类型 | 描述 |
---|---|---|
data.bs_list | live [] | 景区信息列表 |
data.context | string | 续拉分页内容,下一页参数 |
data.size | int | 数据数量 |
data.total | int | 符合条件的总数据数 |
errorcode | int | 错误码 |
msg | string | 错误信息 |
ret | int | 0-成功,1-失败 |
# 直播基本信息live
参数名称 | 类型 | 描述 |
---|---|---|
id | string | id |
type | string | 分类(1-景区,2-景点) |
name | string | 中文名称 |
brief | string | 摘要 |
desc | string | 介绍 |
slogan | string | 一句话简介 |
coverUrl | string | 封面图地址 |
city | string | 所属州市 |
cityId | string | 所属州市id |
district | string | 所属区县 |
districtId | string | 所属区县id |
scenic | string | 所属景区 |
scenicId | string | 所属景区id |
type | int | 直播类型 1-慢直播 |
typeName | string | 直播类型名称 |
viewCount | string | 浏览量 |
likeCount | string | 点赞量 |
collectCount | string | 收藏量 |
playUrl | string | 直播地址 |
isBreakPlay | boolean | 是否正在使用夜间垫片播放 |