获取未观看直播统计V2

GET

https://qyapi.weixin.qq.com/cgi-bin/school/living/get_unwatch_stat_v2

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

权限说明：

「上课直播」应用可以获取用户所有的直播

第三方应用必须有直播权限和家校沟通权限

自建应用必须通知配置到「上课直播」和家长可以使用的应用中

自建应用和第三方应用只能获取本应用创建的直播

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/school/living/get_unwatch_stat_v2' \
--header 'Content-Type: application/json' \
--data-raw '{
	"livingid": "livingid1",
	"next_cursor": "NEXT_CURSOR"
}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "has_more": 1,
  "next_cursor": "NEXT_CURSOR",
  "stat_info": {
    "students": [
      {
        "student_userid": "zhansan_child",
        "partyids": [
          10,
          11
        ]
      },
      {
        "student_userid": "lisi_child",
        "partyids": [
          5
        ]
      }
    ],
    "parents": [
      {
        "parent_userid": "zhangsan",
        "student_userid": "zhansan_child",
        "partyids": [
          10,
          11
        ]
      },
      {
        "parent_userid": "lisi",
        "student_userid": "lisi_child",
        "partyids": [
          5
        ]
      }
    ]
  }
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

livingid

string

直播id

必需

next_cursor

string

必需

上一次调用时返回的next_cursor，初次调用可以填"0"

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

has_more

integer

必需

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

next_cursor

string

必需

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

stat_info

object

统计信息列表

必需

students

array [object {2}]

必需

未观看直播的学生列表

parents

array [object {3}]

必需

未观看直播的家长列表

修改于 2022-12-02 03:43:24

获取观看直播统计V2

获取学生付款结果