服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端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_statusopen_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直播预约人数
上一篇获取成员直播ID列表
下一篇获取直播观看明细
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们