# Exam - 题目

> url 前缀：**exam**
>
> 示例：**https://xxxxxxxxx/api/exam/xxxx**

## 创建考试

[TEACHER]

```http
post /exam
```

### Parameters

```json
{
  "name": string,
  "startAt": timestamp,
  "endAt": timestamp,
  "problem": Array<ProblemSerializer>,
}
```

see [ProblemSerializer](../../problem/serializer/ProblemSerializer.md)

### Response

```json
{
  "res": ExamSerializer,
}
```
see [ExamSerializer](../serializer/ExamSerializer.md)


## 查询某状态下考试

```http
get /exam
```

### Parameters

| Name     | Type   | Description      |
| -------- | ------ | ---------------- |
| status | string | 考试状态 |
| page | number | 当前页数 |
| limit | number | 考试状态 |


### Response

```json
{
  "res": Array<ExamSerializer>,
}
```

see [ExamSerializer](../serializer/ExamSerializer.md)

## 查询单个考试

```http
get /exam/{examId:\d+}
```

### PathVariable

- examId: **number**,考试编号

### Response

```json
{
  "res": ExamSerializer,
}
```

see [ExamSerializer](../serializer/ExamSerializer.md)

## 更新考试信息

[TEACHER]

```http
put /exam/{examId:\d+}
```

### Parameters

```json
{
  "name": string,
  "startAt": timestamp,
  "endAt": timestamp,
  "problems": Array<ProblemSerializer>,
}
```

see [ProblemSerializer](../../problem/serializer/ProblemSerializer.md)

## 删除考试

[TEACHER]

```http
delete /exam/{examId:\d+}
```

### PathVariable

- examId: **number**,考试编号

## 参加考试

```http
post /exam/{examId:\d+}/join
```

### PathVariable

- examId: **number**,考试编号