简要描述:

  • 用户查询频道列表

访问权限

账号类型 是否有权限
主账号
子账号

接口URL:

http://api.zmengzhu.com/business/v1/channel/lists

请求方式:

GET

返回结果格式:

JSON

参数:

参数名 是否必须 类型 默认值 说明
channel_ids string 要查询的频道id 多个英文逗号分隔,不传则默认查询全部
status int 0 条件查询频道,1:直播中 2:回放中 0:不限
offset int 0 分页获取
limit int 10 每页数量

数据返回:

响应成功JSON示例:

{
    "code": 200,
    "msg": "ok",
    "data": {
        "total": 2,
        "list": [
            {
                "id": "1079902", // 频道ID
                "name": "频道1", // 频道名称
                "cover": "http://s1.zmengzhu.com/xxx.png", // 频道封面
                "introduction": "", // 频道简介
                "status": "2" ,// 频道直播状态 1:直播中 2:回放
                "share_title": "于草来说,这应该是最恶劣的环境了吧。砖头",
                "share_desc": "用直播做人生的盟主,我在盟主APP!",
                "share_image": "http://s1.t.zmengzhu.com/business/img/default-cover.png",
            },
            {
                "id": "1079903",
                "name": "频道2",
                "cover": "http://s1.zmengzhu.com/xxx.png",
                "introduction": "",
                "status": "2",
                "share_title": "于草来说,这应该是最恶劣的环境了吧。砖头",
                "share_desc": "用直播做人生的盟主,我在盟主APP!",
                "share_image": "http://s1.t.zmengzhu.com/business/img/default-cover.png",
            }
        ]
    }
}

字段说明:

参数名 说明
code 成功为200
msg 成功返回ok
id 频道ID
name 频道名称
cover 频道封面
introduction 频道简介
status 频道直播状态 1:直播中 2:回放
share_title 分享标题
share_desc 分享描述
share_image 分享图片地址

错误时返回:

{
    "code": 20001,
    "msg": "签名校验失败",
    "data": {}
}