获取直播详情

GET

/cgi-bin/school/living/get_living_info

服务端API企业内部开发第三方应用开发

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

文档ID: 21636
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93740
https://open.work.weixin.qq.com/api/doc/90001/90143/93857

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/school/living/get_living_info?access_token=&livingid={{livingid}}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

livingid

直播ID

必需

示例值:

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

living_info

object

直播信息

可选

comment_num

integer <int32>

评论数

可选

open_replay

integer <int32>

可选

是否开启回放，1表示开启，0表示关闭

living_start

integer <int32>

直播开始时间戳

可选

living_range

object

可选

直播范围，如果直播范围包含的是班级群，优先返回班级群对应班级的partyid，否则直接返回群名称

theme

string

直播主题

可选

push_stream_url

string

可选

推流地址，仅直播类型为活动直播并且直播状态是待开播返回该字段

viewer_num

integer <int32>

群名称列表

可选

anchor_userid

string

主播的userid

可选

living_duration

integer <int32>

直播时长，单位为秒

可选

获取老师直播ID列表

获取观看直播统计