获取观看直播统计

POST

/cgi-bin/school/living/get_watch_stat

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

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

文档ID: 21657
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93741
https://open.work.weixin.qq.com/api/doc/90001/90143/93858

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/school/living/get_watch_stat?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"livingid":"livingid1","next_key":"NEXT_KEY"}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "ending": 1,
  "next_key": "NEXT_KEY",
  "stat_infoes": {
    "students": [
      {
        "student_userid": "zhansan_child",
        "parent_userid": "zhangsan",
        "partyids": [
          10,
          11
        ],
        "watch_time": 30,
        "enter_time": 1586433904,
        "leave_time": 1586434000,
        "is_comment": 1
      },
      {
        "student_userid": "lisi_child",
        "parent_userid": "lisi",
        "partyids": [
          10,
          11
        ],
        "watch_time": 30,
        "enter_time": 1586433904,
        "leave_time": 1586434000,
        "is_comment": 0
      }
    ],
    "visitors": [
      {
        "nickname": "wx_nickname1",
        "watch_time": 30,
        "enter_time": 1586433904,
        "leave_time": 1586434000,
        "is_comment": 1
      },
      {
        "nickname": "wx_nickname2",
        "watch_time": 30,
        "enter_time": 1586433904,
        "leave_time": 1586434000,
        "is_comment": 0
      }
    ]
  }
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

livingid

string

直播的id

必需

next_key

string

可选

上一次调用时返回的next_key，初次调用可以填”0”

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

ending

integer <int32>

可选

是否结束。0：表示还有更多数据，需要继续拉取，1：表示已经拉取完所有数据。注意只能根据该字段判断是否已经拉完数据

stat_infoes

object

统计信息列表

可选

visitors

array [object {5}]

观看直播的游客列表

可选

students

array [object {7}]

观看直播的学生列表

可选

next_key

string

可选

当前数据最后一个key值，如果下次调用带上该值则从该key值往后拉，用于实现分页拉取

errmsg

string

可选

对返回码的文本描述内容

修改于 2022-01-14 04:25:45

获取直播详情

获取未观看直播统计