描述
通过此接口可获取课程上次直播中所有身份用户的详细参课数据,包括学员人数、上课时长等,上课数据有一定时间差需在下课后五分钟左右出结果。只支持查询小课堂和公开课。
接口地址
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 | 课程未统计到直播记录 |