跳转至

事件回调

注: 事件回调只针对旗舰会员及以上开放,其他会员无法调用。

事件回调功能用于将考试结果数据推送到指定业务系统。

一、回调设置

使用事件回调功能前,需要在管理端配置回调地址。 配置路径:

系统设置 → 开放平台设置 → 回调设置
回调配置 配置完成后,通知开发人员根据业务需求开发对应的回调接口。 在回调设置页面可以点击 查看记录,查看每一次回调请求记录。 回调记录


二、试卷设置

进入:

试卷设置 → 考后设置

开启 回调接口。 开启后,每产生一条考试记录,系统会请求一次回调接口。 开启回调设置

注意:当试卷中有问答题时,需要管理员批卷后才会请求回调接口,如果试卷中有AI阅卷的话,也需要等待AI阅卷完毕后请求回调接口


三、调用方式

请求方式:

POST
请求体示例:

{
  "createdAt": "1786005699",        // 发送时间
  "eid": "5114",                   // 试卷ID
  "startTime": "1784536682",       // 考试开始时间
  "endTime": "1784536694",         // 交卷时间
  "name": "1804",                  // 姓名(没有为佚名)
  "pass_radio": "60",              // 及格分数线(%)
  "score": "1",                    // 考生得分
  "secondsTaken": "12",            // 考试用时(秒)
  "secret": "123456",              // 回调密钥
  "sid": "45075",                  // 考生ID(没有为0)
  "submitType": "1",               // 交卷类型:0考试中,1正常交卷,2超时自动交卷,3管理员强制交卷,4系统执行交卷,5答错直接交卷,6切换应用强制交卷,7作弊次数过多强制交卷,8中断次数过多交卷
  "taskid": "d9q4hghhhg4gcbd95ae0", // 业务ID
  "tid": "2079123657476542464",    // 考试记录ID
  "title": "11131",                // 试卷名称
  "total": "10"                    // 试卷总分
}