如何获取考试成绩与查看记录

受众：对接开发者 / 集成负责人（校长可读摘要） · 适用：DodoSpeak Oral

目标：分清「学员在页面里看结果」「你们系统取成绩写回」「接入台演示记录」三层，避免和教务 App 的班级报表混淆。

接入方式前提见 两种正式接入。挂载见 怎么嵌进你们的系统。

三层怎么叫

教务 App 里老师看的「报告 / 班情」是另一套产品，见学生 / 老师指南；Oral 不提供整站教务成绩册后台。

学员如何查看记录（生产）

1. 登录换票：学生在你们系统登录 → 换票带同一 外部用户 id → 打开记录表面，看到自己的会话。
2. 页面挂件：学生先用 学员码（或 OTP / PIN）进入 → 打开记录表面，看到该名册学员下的会话。
3. 两种方式都可以看「我的练习 / 任务 / 考试」历史；不要指望未认人的访客汇总成个人档案。

接入台对照：切到 学员：开口练 → 侧栏 记录。

如何获取考试成绩（生产）

1. 学生走完 考试表面（exam）：热身、计时、交卷（以嵌入页为准）。挂件路径须已完成学员认人。
2. 前端 onCompleted 只表示「页面上像完成了」——成绩以你们后端核对为准。
3. 后端用机构密钥调用 Oral API（或接收 Webhook）拉取评分与交卷结果：
   • 换票：按会话 / 外部用户 id；
   • 挂件：按会话 / 名册学员 id（若名册含学号字段，再映射到你们 LMS）。
4. 再写入你们的成绩册、作业系统或通知老师。

发布人在接入台按人查记录，见 发布人：发布任务；生产等价能力两条接入都有，主键不同（名册人 vs 外部用户 id）。

如何确认成功

• 学员打开记录表面能看到对应练习 / 考试结果（同一身份）。
• 换票路径：后端按外部用户 id 能拉到与交卷一致的成绩字段。
• 挂件路径：后端或接入台按名册学员能拉到成绩；若业务要进学校成绩册，确认学号映射或改用换票。

常见失败

相关阅读

• 两种正式接入：页面挂件与登录换票
• 怎么嵌进你们的系统
• 学员：开口练
• 术语表 · Oral