# 事件回调
使用事件回调功能,需要在管理端 管理中心
- 系统设置
- 开放平台设置
- 回调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) {
// 业务逻辑
}