API-DOC/api/Exam-考试.md

Exam - 考试

url 前缀：exam

示例：https://xxxxxxxxx/api/exam/xxxx

创建考试

TEACHER

post

Parameters

interface ExamDTO {
  name: string;
  startAt: LocalDateTime;
  endAt: LocalDateTime;
  problem: Array<number>;
  courseId: number; // TODO: bed design
}

Response

interface ExamData {
  err: 0;
  res: ExamSerializer;
}

see ExamSerializer

查看考试列表

get

Parameters

Name	Type	Description
page	number	页码
limit	number	每页条数
status	ExamStatus	考试状态

see ExamStatus

Response

interface ExamPageData {
  err: 0;
  res: Array<ExamSerializer>;
  page: PageSerializer;
}

see ExamSerializer, PageSerializer

查看考试信息

TEACHER ADMIN

get /:examId

Response

interface ExamData {
  err: 0;
  res: ExamSerializer;
}

see ExamSerializer

更新考试信息

TEACHER ADMIN

put /:examId

Parameters

interface ExamDTO {
  name: string;
  startAt: LocalDateTime;
  endAt: LocalDateTime;
  problem: Array<number>;
  courseId: number; // TODO: bed design
}

Response

interface ExamData {
  err: 0;
  res: ExamSerializer;
}

see ExamSerializer

删除考试

TEACHER ADMIN

delete /:examId

Response

interface EmptyData {
  err: 0;
}

参加考试

TEACHER STUDENT

post /:examId

Response

interface EmptyData {
  err: 0;
}

获得在线代码（1）

get /:examId/onlinecode

Parameters

Name	Type	Description
userId	number	学生 id

Response

interface CodeData {
  err: 0;
  res: CodeSerializer;
}

see CodeSerializer

获得在线代码（2）

get /:examId/onlinecode/:questionId

Response

interface CodeData {
  err: 0;
  res: CodeSerializer;
}

see CodeSerializer

更新在线代码（1）

post /:examId/onlinecode

Parameters

interface CodeDTOMap {
  [key: number]: {
    code: Map<String, String>;
  };
}

Response

interface EmptyData {
  err: 0;
}

更新在线代码（2）

post /:examId/onlinecode/:questionId

Parameters

interface CodeDTO {
  code: Map<String, String>;
}

Response

interface EmptyData {
  err: 0;
}

获得考试结果

STUDENT ADMIN

get /:examId/result

Response

interface ResultData {
  err: 0;
  res: ResultSerializer;
}

see ResultSerializer