简要描述:

  • 根据活动ID批量查询活动基本信息,最多可批量查询20个活动

  • 获取活动信息列表

访问权限

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

接口URL:

http://api.zmengzhu.com/business/v1/video/list

请求方式:

GET

返回结果格式:

JSON

参数:

参数名 是否必须 类型 说明
ticket_ids string 活动id多个用逗号隔开

返回示例:

响应成功JSON示例:

{
    code: 200,
    msg: "ok",
    data: [{
            ticket_id: "10000570", // 视频观看id
            status: "0", // 直播状态 0:未直播 1:直播中 2:回放 3:断流中
            channel_id: "2049610", // 频道id
            name: "频道2049610", // 活动名称
            introduction: "ererer", // 活动简介
            duration: 100 // 时长
            cover: "https://s1.zmengzhu.com/upload/img/df/ce/dfce2be791741051bd9b9c430c51665c.png", // 封面
            popular: 100 // 活动人气
            stream: {  // 拉流地址(仅限企业版流量计费客户)
                "flash": "rtmp://live.zmengzhu.com/mz/xxxx?auth_key=1587104436-0-0-d14fa8246637ebbda0ccc159813f9f89",
                "html5": "http://live.zmengzhu.com/xxxx.m3u8?auth_key=1587104436-0-0-d14fa8246637ebbda0ccc159813f9f89"
            },
            play_url: "http://link.t.zmengzhu.com/H27", // 播放地址(仅限企业版流量计费客户)
            view_mode:1,//观看方式
            view_mode_ext:{ //观看方式拓展信息
                white_id: "234",
                pay_notice: "大侠,掌柜需要门票,请出示!"
            },
            created_at:1569550366, //活动创建时间
            file_size: "10485760", // 文件占用空间大小 单位为字节
            live_uv:60, // 直播状态访问用户数
            record_uv:100, // 回放状态访问用户数
            real_pv:100, // 活动真实PV数量
            start_time:1569550366, // 开始直播时间
            end_time:1569550466, // 结束直播时间
            live_at:1569550466, // 预计开播时间
            live_volume:10240000, // 直播消耗流量 单位字节(Byte)
            replay_volume :10240000, // 回放消耗流量 单位字节(Byte)
            sum_volume  :20480000, // 视频消耗总流量 单位字节(Byte)
            toggle_share: 1,//是否打开分享开关
            share_info:{
                "share_title": "于草来说,这应该是最恶劣的环境了吧。砖头",
                "share_desc": "用直播做人生的盟主,我在盟主APP!",
                "share_image": "http://s1.t.zmengzhu.com/business/img/default-cover.png",
            }
        },
        ...
    ],
}

字段说明:

参数名 说明
code 成功为200
msg 成功返回ok
ticket_id 视频观看id
status 直播状态 0:未直播 1:直播中 2:回放 3:断流中
channel_id 频道id
name 活动名称
introduction 活动简介
duration 时长
cover 封面
popular 活动人气
stream 拉流地址(仅限企业版流量计费客户)
play_url 播放地址(仅限企业版流量计费客户)
view_mode 观看方式:1免费,4密码,5白名单,6F码
view_mode_ext 观看方式拓展信息,根据观看方式的值不同反回不同的对象信息。1免费:不反回,4密码:{ password: "123"},5白名单:{ white_id": "234},6F码: {fcode_id: 1138}
created_at 活动创建时间
file_size 文件占用空间大小 单位为字节
live_uv 直播状态访问用户数
record_uv 回放状态访问用户数
real_pv 活动真实PV数量
start_time 开始直播时间
end_time 结束直播时间
live_at 预计开播时间
live_volume 直播消耗流量 单位字节(Byte)
replay_volume 回放消耗流量 单位字节(Byte)
sum_volume 视频消耗总流量 单位字节(Byte)
share_info 活动分享信息
toggle_share (int)是否打开分享开关1打开,0关闭

错误时返回:

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