第三方应用开发 服务端API 家校应用 上课直播 获取直播详情
获取直播详情

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/living/get_living_info?access_token=ACCESS_TOKEN&livingid=LIVINGID

 

参数说明:

参数必须说明
access_token调用接口凭证
livingid直播ID

 

权限说明:

  • 「上课直播」应用可以获取用户所有的直播
  • 第三方应用必须有直播权限和家校沟通权限
  • 自建应用必须通知配置到「上课直播」和家长可以使用的应用中
  • 自建应用和第三方应用只能获取本应用创建的直播

返回结果:

{
   "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"
	}
}

参数说明:

参数说明
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推流地址,仅直播类型为活动直播并且直播状态是待开播返回该字段
上一篇
获取老师直播ID列表
下一篇
获取观看直播统计