API-DOC/assignment/api/前端api接口设计.md

Assignment - 作业

url 前缀：/api

获取作业类型

get /assignment/type

Response

{
  "data":List<AssignmentType>
}

see AssignmentType

创建作业

post /assignment

RequestBody

{
  assignmentType：作业类型，String
  name：作业名称，String
  description：作业描述，String
  startAt：开始时间，timestamp
  endAt：开始时间，timestamp
  problem：题目，Number
}

Response

{
  "data": AssignmentVO
}

see AssignmentVO

查看作业(分页)

get /course/:courseId/assignment

RequestParam

不传值时，为获取全部

type:作业类型，String，枚举值如下
			- CODE:编程作业
			- DOCUMENT:文档作业
			- REVIEW:互评作业
			- ML:机器学习作业
status:作业状态，String，枚举值如下
			- PREPARING:准备中
			- UNAVAILABLE:创建失败
			- READY:创建成功，但是作业未到开始时间
			- AVAILABLE:作业开放中
			- FINISHED:作业已经结束
page:页，Number
num:数量，Number

Response

{
  "data": List<AssignmentVO>
}

see AssignmentVO

查看单个作业

get /assignment/:assignmentId

Response

{
  "data": AssignmentVO
}

see AssignmentVO

更新作业信息

post /assignment/:assignmentId

RequestBody

{
  name：作业名称，String
  description：作业描述，String
  startAt：开始时间，timestamp
  endAt：开始时间，timestamp
}

Response

{
  "data": AssignmentVO
}

see AssignmentVO

删除作业

delete /assignment/:assignmentId

作业记录

url 前缀：/api

老师查看作业记录

get /assignment/:assignmentId/record/teacher

Response

{
  "data": List<RecordVO>
}

see RecordVO

学生查看作业记录

get /assignment/:assignmentId/record/student

Response

{
  "data": RecordVO
}

see RecordVO

查看作业记录

get /record/:recordId

Response

{
  "data": RecordVO
}

see RecordVO

作业成绩

url 前缀：/api

查看作业成绩

get /assignment/:assignmentId/result

Response

{
  "data": List<ResultVO>
}

see ResultVO

查看某个作业记录的成绩

get /record/:recordId/result

Response

{
  "data": ResultVO
}

see ResultVO

查看成绩

get /result/:resultId

Response

{
  "data": ResultVO
}

see ResultVO