具体包含时间段内的各类课程数量,及课程维度的各类时长统计
默认接口请求频率限制:20次/秒。
REST URL
POST https://sdk.xylink.com/api/rest/edu/external/statistics/course/extra/data/v1?enterpriseId=分配的企业id
请求参数说明
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 |
departmentIds | List<Long> | Body | 否 | 无 | 部门id集合(不超过10,否则报错) |
areaType | Integer | Body | 否 | 无 | 区域码(1-省,2-市,3-县) |
areaCode | Long | Body | 否 | 无 | 行政区域码 |
statisTime | String | Body | 是 | 无 | 天:yyyy-MM-dd 周:yyyy-MM-dd 月:yyyy-MM |
timeType | Integer | Body | 是 | 无 | 1-天, 2-周, 3-月 |
请求消息体示例(Json)
{
"departmentIds":[12345, 12398], //强制规定数量不超过10个
"statisTime":"2022-03-07或者2022-03", //天:yyyy-MM-dd 周:yyyy-MM-dd 月:yyyy-MM
"timeType":1/2/3 //1-天, 2-周, 3-月
}
或者
{
"areaType":1/2/3,
"areaCode":123,
"statisTime":"2022-03-07或者2022-03", //天:yyyy-MM-dd 周:yyyy-MM-dd 月:yyyy-MM
"timeType":1/2/3 //1-天, 2-周, 3-月
}
补充说明: 部门、区域码必须二选一条件查询数据,部门优先级更高
时间只支持天/周/月维度查询,如果是周查询维度,则指定一周内任意日期都行
返回结果示例:备注:时长单位都统一默认为毫秒
成功时返回结果数据,失败时返回小鱼RESTAPI错误码
{
"areaCode": 520000, //区域码
"areaName":"区域名称" //区域码对应的名称
"interactCount": 102, //互动课程
"liveCount": 452, //直播课程总数
"boutiqueCount": 0, //点播课程总数
"liveViewCount": 0, //直播观看人次
"boutiqueViewCount": 0, //点播观看人次
"prepareCount": 0, //备课总讲次数
"evaluationCount": 0, //听评课次数
"courseMeetingDuration": 0, //课程互动时长
"courseRecordDuration": 0, //课程录制时长
"liveDuration": 0, //课程直播观看时长(暂时不返回该数据)
"liveReplayDuration": 0, //课程回放时长(暂时不返回该数据)
"boutiqueDuration": 0, //互动课程的点播时长
"childs": [ //子数据项
{
"areaCode": 520000,
"areaName":""
"interactCount": 102,
"liveCount": 452,
"boutiqueCount": 0,
"liveViewCount": 0,
"boutiqueViewCount": 0,
"prepareCount": 0,
"evaluationCount": 0,
"courseMeetingDuration": 0,
"courseRecordDuration": 0,
"boutiqueDuration": 0
}
]
}
返回参数说明
参数名称 | 说明 |
areaCode | 区域码 |
areaName | 区域名称 |
interactCount | 互动课程 |
liveCount | 直播课程总数 |
boutiqueCount | 点播课程总数 |
liveViewCount | 直播观看人次 |
boutiqueViewCount | 点播观看人次 |
prepareCount | 备课总讲次数 |
evaluationCount | 听评课次数 |
courseMeetingDuration | 课程互动时长 |
courseRecordDuration | 课程录制时长 |
liveDuration | 课程直播观看时长(暂时不返回该数据) |
liveReplayDuration | 课程回放时长(暂时不返回该数据) |
boutiqueDuration | 互动课程的点播时长 |