第三方应用开发 服务端API 家校应用 上课直播 获取直播详情
获取直播详情
最后更新:2023/12/08
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取直播详情
最后更新:2023/12/08

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/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,
		"anchor_userid": "zhangsan",
		"living_range":{
				"partyids":[1,4,9],
				"group_names":[
					"group_name1",
					"group_name2"
				]
		},
		"viewer_num": 100,
		"comment_num" 110,
		"open_replay": 1,
		"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.anchor_userid主播的userid
living_info.living_range直播范围,如果直播范围包含的是班级群,优先返回班级群对应班级的partyid,否则直接返回群名称
living_info.living_range.partyids班级的partyid列表
living_info.living_range.group_names群名称列表
living_info.viewer_num观看直播总人数
living_info.comment_num评论数
living_info.open_replay是否开启回放,1表示开启,0表示关闭
living_info.push_stream_url推流地址,仅直播类型为活动直播并且直播状态是待开播返回该字段
living_info.online_count当前在线观看人数
living_info.subscribe_count直播预约人数
上一篇
获取老师直播ID列表
下一篇
获取观看直播统计