查询直播进出记录

更新时间：2022-12-28

接口描述

获取一场直播的人员进出记录
说明：只有开始了直播才会有记录，如果学员是在没开启直播进入和退出直播间或者是结束直播后进入和退出直播间，不会产生进出记录

请求地址

https://ccapi.csslcloud.net/collect/live/user/record

请求方式

GET

请求参数

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

名称 类型 必填 描述
userid String 是 开发者账号ID
roomid String 是 直播间ID
liveid String 是 直播ID
viewerid String 否 学员ID，如果填写该参数则只查询该用户的进去记录情况

请求示例

GET https://ccapi.csslcloud.net/collect/live/user/record?userid=41E8063FC799ACE&roomid=D90DCF5BF6DA3C8C9C33DC5901307461&liveid=A01DD608E39FADC59C33DC5901307461&time=1670412086&hash={hash}

返回数据

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

名称 类型 描述
username String 用户名称
viewerid String 用户ID
role String 用户角色：presenter为讲师，talker为学员，assistant为助教，aul为学员(麦下学员，使用大直播间角色)
ip String 学员IP
platform String 平台设备：5为web，2为android，3为ios
enter_time String 用户进入直播间时间；格式：yyyy-MM-dd HH:mm:ss，注：开始直播前进入，该时间就是开始直播时间
exit_time String 用户退出直播间时间；格式：yyyy-MM-dd HH:mm:ss

返回示例


{
    "result": "OK", 
    "data":[{
        "username": "guojia",  
        "viewerid": "ea5e26c98df94e49bb399c477438d7f7", 
        "role":"talker",   
        "ip":  "116.226.32.202",     
        "platform": "web",
        "enter_time":"2017-09-12 16:22:43 ",  
        "exit_time":"2017-09-12 17:22:43 "
    }
    ],
    "error_msg": ""
}

results matching ""

    No results matching ""