Skip to content

管理端接口 ​

教师 / 管理员视角使用的接口。调用前请先读 API 概览 — 鉴权。

大多数情况不用直接调 HTTP

管理端接口主要给前端管理页面用。 如果你只是要做运营后台二次开发,用这些; 如果是要和组织/教务系统对接,拉成绩这类需求用 /stat 下的只读接口即可。

一、题库与分类 ​

方法路径说明
—/question/bank/...题库 CRUD
GET/question/bankCategory/list题库分类列表
GET/question/bankCategory/tree题库分类树

二、试题 ​

前缀 /question。

方法路径说明
GET/question/list题目列表(分页)
POST/question/create新增题目(含选项一次提交)
PUT/question修改题目
DELETE/question/{ids}删除
POST/question/changeBank批量换题库
POST/question/random按规则随机抽题(组卷用)
GET/question/listByIds按 ID 批量查(组卷回显,保持传入顺序)
—/question/option/...选项 CRUD
—/question/tag/...标签 CRUD

随机抽题 ​

http
POST /question/random
Content-Type: application/json

{
  "bankId": "1834523456789012345",
  "questionType": "SINGLE",
  "difficulty": "medium",
  "count": 5
}

候选不足时返回提示,不会静默少返回。详见 试卷与组卷。

Excel 导入导出 ​

操作说明
导入上传 Excel,整批校验,失败整批回滚并逐行报错
导出按当前筛选条件导出

三、试卷 ​

前缀 /paper。

方法路径说明
GET/paper/list试卷列表
GET/paper/{id}试卷详情(含题目明细)
POST/paper新增试卷(基本信息)
POST/paper/save组卷保存(试题明细全量覆盖 paper_question)
PUT/paper修改试卷
DELETE/paper/{id}删除
—/paper/question/...试卷-题目关联查询

/paper/save 是全量覆盖

每次保存按提交明细整体替换 paper_question。删掉的题不会保留。

四、考试管理 ​

前缀 /exam、/invite。

方法路径说明
GET/exam/list考试列表
GET/exam/{id}考试详情
POST/exam新增考试
PUT/exam修改考试
DELETE/exam/{id}删除
POST/exam/{id}/joinCode/refresh刷新加入码
GET/exam/join/{code}查询加入码对应的考试
POST/exam/join/{code}加入考试
GET/exam/{id}/whiteUsers查询白名单考生
PUT/exam/{id}/whiteUsers设置白名单考生
GET/exam/{id}/situation/overview考试情况看板
GET/exam/{id}/situation/records考试情况明细
—/invite/...邀请记录

权限标识 ​

text
system:exam:query     system:exam:add
system:exam:edit      system:exam:remove
system:exam:export

详见 用户与角色权限。

五、阅卷 ​

前缀 /mark。

方法路径说明
GET/mark/exam/list待阅卷考试列表(含进度)
GET/mark/task/list答卷列表
GET/mark/task/{taskId}/questions某份答卷的主观题明细
GET/mark/task/{taskId}/logs阅卷日志(改分审计)
POST/mark/score提交打分
POST/mark/task/{taskId}/finish完成阅卷(未打分题按 0 分)
POST/mark/task/{taskId}/aiAI 批量预评(当前未接入)

详见 阅卷与成绩。

六、统计 ​

前缀 /stat。这是对接教务/BI 系统最有用的一组接口。

方法路径说明
GET/stat/home/overview首页概览
GET/stat/dashboard统计大盘
GET/stat/exam/page考试分页列表(含统计指标)
GET/stat/exam/{id}/overview单场考试概览
GET/stat/exam/{id}/segment分数段分布
GET/stat/exam/{id}/users考生明细与排名
GET/stat/exam/{id}/user/{userId}/detail单个考生答卷明细
GET/stat/exam/{id}/questions逐题分析(正确率/难度/区分度)
GET/stat/exam/{id}/knowledge知识点掌握度
POST/stat/exam/{id}/recalc手动触发重算
PUT/stat/exam/{id}/record/{recordId}/exclude作废答卷(不入统)

数据不对先调 recalc

统计是预计算的(每 10 分钟定时重算)。改完分数想立刻看到结果, 调一次 /stat/exam/{id}/recalc 即可。

权限标识:exam:stat:*。详见 成绩与学情分析。

七、证书 ​

前缀 /cert。

方法路径说明
GET/cert/list证书模板列表
GET/cert/option/list模板下拉选项
GET/PUT/POST/cert模板 CRUD
DELETE/cert/{ids}删除模板
GET/cert/record/list颁发记录列表
GET/cert/record/count颁发数量统计
POST/cert/record/issue手工颁发(补发)
PUT/cert/record/revoke/{id}吊销(需原因)
GET/cert/mine/list我的证书(考生侧)
GET/cert/mine/record/{recordId}我的证书(某场考试)

权限标识:exam:cert:{add,edit,remove,issue}。详见 证书管理。

八、监考 ​

前缀 /proctor,管理侧接口。

方法路径说明
GET/proctor/exam/list我的考试分组列表
GET/proctor/session/list监考会话列表
GET/proctor/overview风险概览
GET/proctor/session/{id}会话详情
GET/proctor/event/list事件流水
GET/proctor/snapshot/list抓拍列表

权限标识:exam:proctor:list。详见 在线监考与防作弊。

九、考试情况导出 ​

http
GET /exam/{examId}/situation/export

统计大盘的导出还没做

/stat/dashboard 的导出目前提示「导出功能将在导出中心提供」。 单场考试各维度的导出是可用的。

错误处理 ​

HTTP 状态常见原因
401Token 缺失/过期,见 放行接口认证失败
403该账号没有对应权限标识
400参数校验失败,msg 里有具体字段
500服务端异常,查对应服务日志

相关 ​

砚考 · 让每一次考试都经得起检验