# 获取地区直播区列表数据

# 适用应用类型

  • 通用

# 接口地址

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

可能存在返回的数据结构中不包含以下某个字段——这说明该字段属于非必需字段。游云南内部在建立数据时未填写该字段,所以业务数据库未存储该字段。

请求接口时,返回满足以下条件的慢直播流

  1. 在线状态
  2. 运营状态是启用状态
  3. 推流时间至今大于15分钟
  4. 夜间时,根据直播属性,不适合夜间展示的切为视频垫片;适合夜间展示的正常使用直播流
参数名称 类型 描述
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 是否正在使用夜间垫片播放
上次更新: 9/23/2022, 5:18:29 PM