# 事件回调
使用事件回调功能，需要在管理端 管理中心 - 系统设置 - 开放平台设置 - 回调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) {
// 业务逻辑
}
# 学习地图完成信息回调
# 功能说明
学员完成学习地图（新员工培训）学习后，轻速云平台可以将学习信息推送到您自己平台的接口，您的平台可以实时获取到学员学习结果数据。学习地图完成信息回调功能需要在学习地图设置里开启，具体开启流程如下。
在学习地图设置里，可以看到启用回调开关，启用之后此学习地图的学习结果才会实时推送到您的平台。
# 调用方式
方式：post
# 回调请求体示例
{
"ts":"2022-01-08 17:39:42.388", // 事件发送的时间
"uuid":"4ad6a21fada241e9aeff90d814779fcb", // 事件的唯一标识
"secretKey":"2918148edb9a4939857a8b3a387127f6", // 校验密钥，管理端系统资料 - 密钥
"type":"mapFinish", // 消息类型 mapFinish:学习地图回调
"callbackUrl":"http://www.***.com/eventCallBack", // 回调URL
"eventBody":{
"id": "9999", //学习地图id
"name": "回调地图123", //学习地图名称
"mustProgress": 1, //必修课件学习进度
"selectProgress": 0.5, //选修课件学习进度
"totalTaskNum": 4, //学习地图任务数量
"finishedCount": 4, //学员完成课件数
"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": "2026-01-04 17:36:25.760", // 事件发送的时间
"uuid": "d91d4b81008146c1b1a7b57015d2aab5", // 事件的唯一标识
"secretKey": "xfbca1ecf82a48b5b4h828dtae1d1160", // 校验密钥，管理端系统资料 - 密钥
"type": "taskFinish", // 消息类型 taskFinish:学习地图任务回调
"callbackUrl": "https://www.***.com/eventCallBack", // 回调URL
"eventBody": {
"id": "c326ef84b519404cb3a9bff0362ab549", // 学习地图任务记录主键id（可忽略）
"factoryCode": "100000", // 租户编号
"mapId": 9115, // 学习地图id
"mapRecordId": "360e4565fe39456ea1cd1742f45ef44b", // 学习地图学员学习记录id（可忽略）
"userId": "d55eda2b73244028b1f566e29c6f7eaf", // 学员id
"mapTaskId": "2d1c1720e48111f089faa088c2a75020", // 学习地图任务id
"eventId": "fd7a29567f5945d89e6611c26425cd23", // 关联项目id，如考试则为试卷id
"eventType": 1, // 学习地图任务类型（0知识，1课程，2考试，3报名，4问卷，5证书，6作业，7培训班，8考勤，9考核，10AI陪练，11直播，12练习）
"credit": 0, // 学习地图任务积分
"finished": 1, // 学习地图任务完成状态（可忽略）
"finishedTime": 1767519385000, // 学习地图任务完成时间
"createTime": 1767519348000 // 学习地图任务开始时间
}
}
接收方法示例（JAVA）：
@PostMapping("/eventCallBack")
public void eventCallBack(@RequestBody Map<String, Object> params, HttpServletRequest request, HttpServletResponse response) {
// 业务逻辑
}