获取未观看直播统计 - Developer OpenAPI

通过该接口可以获取未观看直播的学生统计，学生的家长必须是已经关注「学校通知」才会纳入统计范围。

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

文档ID: 21653
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93742
https://open.work.weixin.qq.com/api/doc/90001/90143/93859

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

livingid

string

直播id

必需

next_key

string

可选

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

示例

{
  "livingid": "livingid1",
  "next_key": "NEXT_KEY"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

ending

integer <int32>

可选

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

next_key

string

可选

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

errmsg

string

可选

对返回码的文本描述内容

stat_info

object

统计信息列表

可选

students

array [object {3}]

可选

未观看直播的学生列表

示例

{
  "errcode": 0,
  "ending": 0,
  "next_key": "string",
  "errmsg": "string",
  "stat_info": {
    "students": [
      {
        "student_userid": "string",
        "partyids": [
          0
        ],
        "parent_userid": "string"
      }
    ]
  }
}