创建空试卷 (Create)

Method: POST

Endpoint:

/api/v1/exams

创建一张空试卷，先占坑并登记试卷名。新试卷的 json 初始为 {}。

请求参数

Body (JSON):

字段	类型	必填	说明
name	String	是	试卷名，1–100 字符，不能重复

规则：

• 不能有首尾空白；
• 不能包含 Windows 文件名非法字符 <>:"/\|?*；
• 数据库对 exam 列建立唯一索引，同名返回 409，不会覆盖旧记录。

请求示例：

{
  "name": "高一数学第一次月考答题卡"
}

响应示例

首次创建返回 201：

{
  "data": {
    "id": 1,
    "name": "高一数学第一次月考答题卡",
    "exam": {}
  }
}

错误

• 400 / VALIDATION_ERROR：name 缺失或格式不合法
• 401 / UNAUTHORIZED：未鉴权
• 409 / EXAM_NAME_EXISTS：存在同名试卷
• 415 / UNSUPPORTED_MEDIA_TYPE：不是 application/json
• 503 / AUTH_NOT_CONFIGURED：未配置 EXAM_API_TOKEN