AUBB 文档中心

Appearance

批改与成绩接口 ​

1. 接口清单 ​

1.1 教师批改 ​

方法路径说明权限
POST/teacher/submissions/{submissionId}/answers/{answerId}/grade人工批改单题教师 / 助教

1.2 成绩管理 ​

方法路径说明权限
POST/teacher/assignments/{assignmentId}/grades/batch-adjust批量调分教师
GET/teacher/assignments/{assignmentId}/grades/import-template下载成绩导入模板教师
POST/teacher/assignments/{assignmentId}/grades/import导入成绩教师
POST/teacher/assignments/{assignmentId}/grades/publish发布 / 重新发布成绩教师 / 整课助教

1.3 教师成绩册 ​

方法路径说明权限
GET/teacher/course-offerings/{offeringId}/gradebook开课实例成绩册教师
GET/teacher/course-offerings/{offeringId}/gradebook/export导出开课成绩册教师
GET/teacher/course-offerings/{offeringId}/gradebook/report开课成绩统计教师
GET/teacher/teaching-classes/{teachingClassId}/gradebook教学班成绩册教师 / 助教
GET/teacher/teaching-classes/{teachingClassId}/gradebook/export导出教学班成绩册教师 / 助教
GET/teacher/teaching-classes/{teachingClassId}/gradebook/report教学班成绩统计教师 / 助教
GET/teacher/course-offerings/{offeringId}/students/{studentUserId}/gradebook单学生成绩册教师

1.4 学生成绩册 ​

方法路径说明权限
GET/me/course-offerings/{offeringId}/gradebook我的成绩册已登录
GET/me/course-offerings/{offeringId}/gradebook/export导出我的成绩册已登录

2. 人工批改 ​

POST /api/v1/teacher/submissions/{submissionId}/answers/{answerId}/grade

请求体：

json
{
  "score": 30,
  "feedbackText": "边界条件处理不完整"
}

3. 发布成绩 ​

POST /api/v1/teacher/assignments/{assignmentId}/grades/publish

业务规则：

  • 设置作业的 grade_published_at 时间戳，标志成绩已发布。
  • 首次发布返回 initialPublication=true；重新发布返回 initialPublication=false，不重置首次发布时间。
  • 响应包含 assignmentId、publishedByUserId、publishedAt 和 initialPublication。
  • 发布后会触发通知事件；重新发布会写入审计记录。
  • 学生侧成绩册只在成绩发布后展示最终可见结果。

4. 成绩册说明 ​

  • 教师侧成绩册默认按每个学生每个作业最新正式提交聚合。
  • offering 级成绩册只对教师 / 管理员开放。
  • class 级成绩册额外对具备班级责任的 TA 开放。
  • 教师侧成绩册 assignmentColumns[] 返回 gradePublished、gradePublishedAt、gradePublishedByUserId，用于页面展示已发布状态、发布时间、发布人和重新发布语义。
  • 教师侧成绩统计 assignments[] 返回 applicableStudentCount、publishedStudentCount 和 publicationRate，用于展示学生可见范围。
  • 学生侧仅展示已发布 assignment 的结构化作业成绩。
  • 成绩册导出是文件下载，不是 JSON。