描述

通过此接口可获取课程上次直播中所有身份用户的详细参课数据,包括学员人数、上课时长等,上课数据有一定时间差需在下课后五分钟左右出结果。只支持查询小课堂和公开课。

接口地址

http://api-class.e.vhall.com/api/class/statistics/get-class-user-time

请求参数

公共参数需要每次请求都附带上,详细内容请参考公共参数

参数名 类型 必选 说明
class_id string 课程ID
child_id int 子账号ID

响应参数

返回数据如下:

参数名 类型 说明
code int 响应状态码 200 代表成功
msg string 响应失败时的描述
class_info object 课程信息
class_id string 课程ID
last_start_time string 上一次开课时间
last_end_time string 上一次下课时间
total_user int 总用户数
total_student int 学生人数
total_assistant int 助教人数
total_guest int 嘉宾人数
total_supervisor int 监课人数
max_online_num int 当前课程单位分钟内最高在线人数
user_info object 用户信息
join_id string 参会id
role int 角色 1老师 2学员 3助理 4嘉宾 5监课
ip string 各身份用户的IP地址
time_in string 用户进入课堂时间
time_out string 用户离开课堂时间
duration int 用户停留时长单位为秒
custom_id string 自定义id(用户账户体系中的用户ID,同一个ID只能对应一个角色)
isp string 运营商(例如:联通、移动等)
browser string 浏览器信息
viewer_country string 国家
viewer_province string
viewer_city string

响应示例

{
    "code": 200,
    "msg": "",
    "data": {
        "class_info": {
            "class_id": "edu_b1307cf3",
            "last_start_time": "2018-07-23 17:14:24",
            "last_end_time": "2018-07-23 17:20:00",
            "total_user": 6,
            "total_teacher": 1,
            "total_student": 4,
            "total_assistant": 0,
            "total_guest": 0,
            "total_supervisor": 1,
			"max_online_num":3
        },
        "user_info": [
            {
                "join_id": "40055",
                "role": 1,
                "ip": "1.119.193.36",
                "time_in": "2018-07-23 17:15:00",
                "time_out": "2018-07-23 17:20:00",
                "duration": 300,
				"custom_id":1000,
				"isp":"移动",
				"browser":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36",
				"viewer_country":"中国",
				"viewer_province":"北京",
				"viewer_city":"北京"
            },
            {
                "join_id": "40080",
                "role": 5,
                "ip": "1.119.193.36",
                "time_in": "2018-07-23 17:15:00",
                "time_out": "2018-07-23 17:16:00",
                "duration": 60,
				"custom_id":1001,
				"isp":"移动",
				"browser":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36",
				"viewer_country":"中国",
				"viewer_province":"北京",
				"viewer_city":"北京"
            },
            {
                "join_id": "40066",
                "role": 2,
                "ip": "1.119.193.36",
                "time_in": "2018-07-23 17:15:00",
                "time_out": "2018-07-23 17:16:00",
                "duration": 60,
				"custom_id":1002,
				"isp":"移动",
				"browser":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36",
				"viewer_country":"中国",
				"viewer_province":"北京",
				"viewer_city":"北京"
            },
            {
                "join_id": "40065",
                "role": 2,
                "ip": "1.119.193.36",
                "time_in": "2018-07-23 17:15:00",
                "time_out": "2018-07-23 17:16:00",
                "duration": 60,
				"custom_id":1003,
				"isp":"移动",
				"browser":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36",
				"viewer_country":"中国",
				"viewer_province":"北京",
				"viewer_city":"北京"
            },
            {
                "join_id": "40064",
                "role": 2,
                "ip": "1.119.193.36",
                "time_in": "2018-07-23 17:15:00",
                "time_out": "2018-07-23 17:16:00",
                "duration": 60,
				"custom_id":1004,
				"isp":"移动",
				"browser":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36",
				"viewer_country":"中国",
				"viewer_province":"北京",
				"viewer_city":"北京"
            },
            {
                "join_id": "40067",
                "role": 2,
                "ip": "1.119.193.36",
                "time_in": "2018-07-23 17:15:00",
                "time_out": "2018-07-23 17:16:00",
                "duration": 60,
				"custom_id":1005,
				"isp":"移动",
				"browser":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36",
				"viewer_country":"中国",
				"viewer_province":"北京",
				"viewer_city":"北京"
            }
        ]
    }
}

错误码

code 含义
10005 课程不存在
10042 课程未统计到直播记录