查询点名信息

更新时间：2023-06-27

接口描述

查询直播点名数据
说明：直播中使用了点名工具，结束直播后可以查看点名的信息

请求地址

https://ccapi.csslcloud.net/openapi/collect/rollcall/get

请求方式

GET

请求参数

接口统一权限认证请参考THQS认证方式。

名称 类型 必填 描述
account_id String 是 开发者账号ID
live_id String 是 直播ID
page_index Integer 否 第几页，默认1。取值范围：大于1的整数
page_num Integer 否 每页记录条数，默认50。取值范围：1~500整数

请求示例

GET https://ccapi.csslcloud.net/openapi/collect/rollcall/get?account_id=41E8063FC799ACE&live_id=A01DD608E39FADC59C33DC5901307461&time=1670412086&hash={hash}

返回数据

公共返回数据结构请参考 公共返回数据说明。

名称 类型 描述
total Integer 总记录条数
size Integer 每页记录条数
current Integer 页码 ，第几页
data Array 点名列表

data说明

名称 类型 描述
live_id String 直播ID
roll_call_id String 点名ID
user_id String 用户ID，课堂内学员ID
user_name String 用户名称，课堂内学员名称
roll_call_status Integer 点名状态：1为点名成功，0为点名失败
confirm_time String 点名确认时间，格式：yyyy-MM-dd HH:mm:ss
user_role String 用户角色

返回示例

{
    "result": "OK",
    "error": null,
    "data": {
        "total": 2,
        "size": 100, 
        "current": 1, 
        "data": [
            { 
                "live_id": "435FD0F38E66EE6A", 
                "roll_call_id": "1591856163000", 
                "user_id": "a10b241e28b44ab88a640539a09e681b", 
                "user_name": "123", 
                "roll_call_status": 1, 
                "confirm_time": "2020-06-11 14:16:12",
                "user_role" : "talker"
            },
            {
                "live_id": "435FD0F38E66EE6A",
                "roll_call_id": "1591856163000",
                "user_id": "Z803hxkfgI65dwwC",
                "user_name": "学生",
                "roll_call_status": 1,
                "confirm_time": "2020-06-11 14:16:15",
                "user_role" : "talker"
            }
        ]
    },
    "errorMsg": ""
}

results matching ""

    No results matching ""