登录
基础
连接微信
办公
企业内部开发 服务端API 直播 获取直播详情
获取直播详情
最后更新：2023/12/01
请求方式：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 | 直播预约人数 |
- 获取直播详情
本节内容
