请求方式:GET(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/living/get_living_info?access_token=ACCESS_TOKEN&livingid=LIVINGID
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
livingid | 是 | 直播ID |
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「上课直播/直播 - 可调用接口的应用」中 |
代开发应用 | 具有「直播」权限 |
第三方应用 | 具有「直播」权限 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{ "errcode": 0, "errmsg": "ok", "living_info":{ "theme": "直角三角形讲解", "living_start": 1586405229, "living_duration": 1800, "status ": 3, "reserve_start": 1586405239, "reserve_living_duration": 1600, "description": "小学数学精选课程", "anchor_userid": "zhangsan", "main_department": 1, "viewer_num": 100, "comment_num": 110, "mic_num": 120, "open_replay": 1, "replay_status": 2, "type": 0, "push_stream_url": "https://www.qq.test.com", "online_count": 1, "subscribe_count": 1 } }
点击复制
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
living_info | 直播信息 |
living_info.theme | 直播主题 |
living_info.living_start | 直播开始时间戳 |
living_info.living_duration | 直播时长,单位为秒 |
living_info.status | 直播的状态,0:预约中,1:直播中,2:已结束,3:已过期,4:已取消 |
living_info.reserve_start | 直播预约的开始时间戳 |
living_info.reserve_living_duration | 直播预约时长,单位为秒 |
living_info.description | 直播的描述,最多支持100个汉字 |
living_info.anchor_userid | 主播的userid |
living_info.main_department | 主播所在主部门id |
living_info.viewer_num | 观看直播总人数 |
living_info.comment_num | 评论数 |
living_info.mic_num | 连麦发言人数 |
living_info.open_replay | 是否开启回放,1表示开启,0表示关闭 |
living_info.replay_status | open_replay为1时才返回该字段。0表示生成成功,1表示生成中,2表示回放已删除,3表示生成失败 |
living_info.type | 直播的类型,0:通用直播,1:小班课,2:大班课,3:企业培训,4:活动直播 |
living_info.push_stream_url | 推流地址,仅直播类型为活动直播并且直播状态是待开播返回该字段 |
living_info.online_count | 当前在线观看人数 |
living_info.subscribe_count | 直播预约人数 |