核心要点
对接应先明确身份登录、课程入口、任务标识和成绩回传,再确认数据权限、网络条件与异常处理。双方依据现有接口形成字段清单和联调计划,通过完整训练验证登录、记录和回传,而不是只验证页面能够打开。
先列清需要打通的四类信息
| 关注项 | 配置与核验要点 |
|---|---|
| 身份与权限 | 用户标识、教师与学生角色、登录方式及退出行为。 |
| 课程与任务 | 课程标识、任务入口、病例对应关系和发布范围。 |
| 记录与成绩 | 训练标识、完成状态、评分口径、回传时机及重复提交处理。 |
| 运维与责任 | 接口文档、网络条件、联调人员、故障查询和维护边界。 |
登录协议与业务数据分别确认
OpenID Connect是基于OAuth 2.0的身份认证协议,可作为统一登录方案的技术参考。但统一登录成功,不代表课程、病例和成绩已经打通。应分别确认双方现有协议、字段映射、权限和业务接口;具体产品是否支持某种协议需要演示验证。
- 只传递任务所需的数据,明确哪些记录留在教学平台、哪些回传学校系统。
- 接口凭据由双方技术人员管理,明确授权、失效和更新方式。
- 明确教师复核后的成绩与自动评分结果如何区分。
联调验收要覆盖正常与异常路径
用测试账号完成登录、进入指定任务、结束训练、查看报告和回传成绩。另行检查权限不足、授权失效、重复提交及网络中断后的处理,确认双方记录一致。将已验证接口与仍需开发的部分分别列明,再确定交付时间与费用。
参考资料
国内资料用于了解政策背景与本土教学要求,国外资料用于课程设计、模拟教学或技术标准参考。具体课程与项目采用的版本,应结合使用单位要求确认。