# 事件回调

使用事件回调功能,需要在管理端 管理中心 - 系统设置 - 开放平台设置 - 回调URL 配置您的回调地址,配置好之后通知您的开发人员针对回调业务做对应的接口开发。

提示

回调成功则返回success字符串,其余返回结果均为失败。

# 答卷回调

# 功能说明

学员考试结束成功交卷后,轻速云平台可以将考试结果推送到您自己平台的接口,您的平台可以实时获取到学员考试结果数据。答卷回调功能需要在试卷设置里开启,具体开启流程如下。

在试卷设置里,考试后的配置中,可以看到启用回调开关,启用之后此试卷的考试结果才会实时推送到您的平台。

# 调用方式

方式:post

# 回调请求体示例

{
    "ts":"2022-01-08 17:39:42.388", // 事件发送的时间
    "uuid":"229381ace3264e7ba8bf6d520d30922a", // 事件的唯一标识
    "secretKey":"2918148edb9a4939857a8b3a387127f6", // 校验密钥,管理端系统资料 - 密钥
    "type":"answerSheet", // 消息类型 answerSheet:答卷内容回调
    "callbackUrl":"http://www.***.com/eventCallBack", // 回调URL
    "eventBody":{
        "id":"d7453b7a9a6f4fe892d5c7895a95b5c8", // 答卷id
        "paperId":"18081428190", // 试卷ID
        "paperName":"试卷名称",
        "userId":"d7453b7a9a6f4fe892d5c7895a95b5c8", // 成员ID
        "examineeCode":"zhanghao", // 成员账号
        "examineeName":"张三", // 成员姓名
        "totalScore":100, // 试卷总分
        "passScore":60, // 试卷及格分
        "realScore":0, // 成员考试得分
        "useDuration":6, // 考试用时(单位:秒)
        "judged":1, // 是否已判卷,1为已判卷,空和0为未判卷,未判卷的答卷需要后台阅卷
        "startTime":1641634772902, // 开始考试时间
        "endTime":1641634779413 // 完成考试时间
    }
}

提示

示例为非公开试卷,若为公开试卷,则会携带采集信息。

接收方法示例(JAVA):

@PostMapping("/eventCallBack")
public void eventCallBack(@RequestBody Map<String, Object> params, HttpServletRequest request, HttpServletResponse response) {
    // 业务逻辑
}

# 课程完成信息回调

# 功能说明

学员完成课程学习后,轻速云平台可以将学习信息推送到您自己平台的接口,您的平台可以实时获取到学员学习结果数据。课程完成信息回调功能需要在课程设置里开启,具体开启流程如下。

在课程设置里,其他设置中,可以看到启用回调开关,启用之后此课程的学习结果才会实时推送到您的平台。

# 调用方式

方式:post

# 回调请求体示例

{
    "ts":"2022-01-08 17:39:42.388", // 事件发送的时间
    "uuid":"229381ace3264e7ba8bf6d520d30922a", // 事件的唯一标识
    "secretKey":"2918148edb9a4939857a8b3a387127f6", // 校验密钥,管理端系统资料 - 密钥
    "type":"courseFinish", // 消息类型 courseFinish:课程回调
    "callbackUrl":"http://www.***.com/eventCallBack", // 回调URL
    "eventBody":{
                "courseId": "b3fbfab6df73439e81f741d4ef7e5cc7", //课程id
                "courseName": "回调课程111", //课程名称
                "coursewareCount": 4, //课程所含课件数
                "finishedCount": 4,   //学员完成课件数
                "finishedTime": 1664521661000, //完成时间
                "id": "248c84c209004b0fb0e719406a7f35e5", //课程进度id
                "nickName": "月清疏", //学员姓名
                "studyedDuration": 110, //学习时长
                "userCode": "1001",  //学员账号
                "userId": "11bf7d9d6c9c426980d5f6e8ca163c01" //学员id
        }
}

接收方法示例(JAVA):

@PostMapping("/eventCallBack")
public void eventCallBack(@RequestBody Map<String, Object> params, HttpServletRequest request, HttpServletResponse response) {
    // 业务逻辑
}

# 课件完成信息回调

# 功能说明

学员完成课件学习后,轻速云平台可以将学习信息推送到您自己平台的接口,您的平台可以实时获取到学员学习结果数据。课件完成信息回调功能需要在课程设置里开启,具体开启流程如下。

在课程设置里,其他设置中,可以看到启用回调开关,启用之后此课程对应课件的学习结果才会实时推送到您的平台。

# 调用方式

方式:post

# 回调请求体示例

{
    "ts":"2022-01-08 17:39:42.388", // 事件发送的时间
    "uuid":"229381ace3264e7ba8bf6d520d30922a", // 事件的唯一标识
    "secretKey":"2918148edb9a4939857a8b3a387127f6", // 校验密钥,管理端系统资料 - 密钥
    "type":"coursewareFinish", // 消息类型 coursewareFinish:课程-课件回调
    "callbackUrl":"http://www.***.com/eventCallBack", // 回调URL
    "eventBody": {
        "courseCatalogId": "95fe7c9f8938415ea081221321ab8f2a", //课件记录id
        "courseId": "b3fbfab6df73439e81f741d4ef7e5cc7",  //课程id
        "courseName": "回调课程111", //课程名称
        "coursewareId": "e5931d8dc06c43f9be46900381bcdd94", //课件id
        "coursewareName": "单独的课件学15秒", //课件名称
        "finished": 1, //是否完成
        "finishedTime": 1664522482000, //完成时间
        "id": "a0045b461b244d8685e1567b3c106cbd",
        "nickName": "林黛玉", //学员姓名
        "progress": 0, //学习进度
        "startTime": 1664522468000, //开始时间
        "studyDuration": 15, //学习时长
        "userCode": "1003", //学员账号
        "userId": "51d52d99793f407d996d40f2021f3680" //学员id
    }
}

接收方法示例(JAVA):

@PostMapping("/eventCallBack")
public void eventCallBack(@RequestBody Map<String, Object> params, HttpServletRequest request, HttpServletResponse response) {
    // 业务逻辑
}

# 打卡完成信息回调

# 功能说明

学员完成打卡学习后,轻速云平台可以将打卡结果信息推送到您自己平台的接口,您的平台可以实时获取到学员学习结果数据。打卡完成信息回调功能需要在打卡设置里开启,具体开启流程如下。

# 调用方式

方式:post

# 回调请求体示例

{
        "ts": "2023-07-13 09:53:17.017", // 事件发送的时间
        "uuid": "82d4d230d1ce403e9e457dff93dd0dbd", // 事件的唯一标识
        "secretKey": "4d5f3185284041f0b00d1c3f79a50f62", // 校验密钥,管理端系统资料 - 密钥
        "type": "clockFinish", // 消息类型 clockFinish:打卡学习回调
        "callbackUrl": "http://xxxxx/finishCallBack", // 回调URL
        "eventBody": {
                "id": "58297eb5cabb4b0d9b7720635d9ab75a", // 答卷id
                "clockId": "9999", //打卡任务id
                "clockName": "打卡任务名称",
                "days": 1, //坚持天数
                "examineeCode": "1002", // 成员账号
                "examineeName": "龙葵", // 成员姓名
                "totalAmount": 1, // 总题数
                "wrongAmount": 1, // 答错题数
                "startTime": 1689213152000, // 答题开始时间
                "endTime": 1689213158000, // 答题结束时间
                "rightRatio": "0.00%" // 正确率
        }
}

接收方法示例(JAVA):

@PostMapping("/eventCallBack")
public void eventCallBack(@RequestBody Map<String, Object> params, HttpServletRequest request, HttpServletResponse response) {
    // 业务逻辑
}