艺术类招生政策

接口概述

项目	内容
接口名称	获取艺术类招生政策信息
请求方法	POST
请求路径	/api/v1/enrollment/art-policy
是否需要登录	否（登录且未传省份时自动补全用户省份）

---

请求参数

参数名	类型	必填	说明
year	number	否	年份，默认当前年份减1
province	string	否	省份，如"江苏"、"北京"等；未传且登录时自动取用户省份
art_category	string	否	艺术类别
exam_type	string	否	考试类型（对应title字段）
school_name	string	否	院校名称（模糊搜索考试安排content字段）
exam_date	string	否	考试日期，格式如"2024-03-15"

---

返回结构

{
  "exam_schedule": [
    {
      "date": "2024-03-15",
      "type": "统考",
      "school_name": "某艺术学院",
      "location": "北京市海淀区",
      "majors": "绘画、雕塑"
    }
  ],
  "admission_rules": [
    {
      "title": "录取规则一",
      "rule_desc": "具体规则内容...",
      "rule_img": "https://example.com/img.png"
    }
  ],
  "application_guide": [
    {
      "date": "2024-03-01",
      "content": "报名开始..."
    }
  ],
  "exam_dates": ["2024-03-15", "2024-03-20"]
}

---

返回字段说明

字段	类型	说明
exam_schedule	array	考试安排列表
exam_schedule[].date	string	考试日期（格式：YYYY-MM-DD）
exam_schedule[].type	string	考试类型
exam_schedule[].school_name	string	院校名称
exam_schedule[].location	string	考试地点
exam_schedule[].majors	string	涉及专业
admission_rules	array	录取规则列表
admission_rules[].title	string	规则标题
admission_rules[].rule_desc	string	规则描述（content字段）
admission_rules[].rule_img	string	录取规则图解图片
application_guide	array	报考指南时间线
application_guide[].date	string	日期/节点标题（title字段）
application_guide[].content	string	内容说明
exam_dates	string[]	考试时间数组（去重排序）

---

调用示例

curl -X POST http://localhost:3666/api/v1/enrollment/art-policy \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "year": 2024,
    "province": "江苏",
    "art_category": "美术",
    "exam_type": "统考"
  }'

---

注意事项

• 未传 province 且用户已登录时，自动从用户表查询用户省份
• infoType 区分数据类型：1=考试安排，2=录取规则，3=报考指南
• 考试安排支持按 art_category、exam_type（对应title字段）、school_name（content字段模糊搜索）、exam_date（日期范围）筛选
• exam_dates 从 exam_schedule 中提取并去重排序

---

同模块相关接口

1. 招生批次（batch）

项目	内容
请求路径	/api/v1/enrollment/batch
请求方法	POST

请求参数

参数名	类型	必填	说明
year	number	否	年份
province	string	否	省份
subject_type	string	否	科类

subject_type 的可用值可通过动态接口获取：POST /api/v1/meta/subjects，source 传 "plans"。

返回结构

[
  {
    "id": 1,
    "year": 2024,
    "province": "江苏",
    "xuanke": "物理+化学+生物",
    "name": "本科一批",
    "period": "7月15日-7月20日",
    "volunteer_time": "6月28日-7月2日",
    "description": "批次描述...",
    "introduction": "批次介绍...",
    "school_range": ["985院校", "211院校"],
    "rules": [{"name": "平行志愿", "desc": "..."}],
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  }
]

• school_range 和 rules 为 JSON 字段，空值返回 []

---

2. 特殊类型招生-计划列表（special-plan）

项目	内容
请求路径	/api/v1/enrollment/special-plan
请求方法	POST

请求参数

参数名	类型	必填	说明
year	number	否	年份
province	string	否	省份；未传且登录时自动取用户省份
plan_type	number	否	计划类型：1国家专项，2地方专项，3高校专项
keyword	string	否	关键词（仅对国家专项计划生效，搜索school_name和spname）
page	number	否	页码，默认1
limit	number	否	每页数量，默认10

返回结构

{
  "total": 100,
  "list": [
    {
      "sid": 123,
      "major_id": 456,
      "year": 2024,
      "province": "江苏",
      "school_name": "南京大学",
      "spname": "计算机科学与技术",
      "num": 30,
      "min": 650,
      "min_section": 2000,
      "local_batch_name": "国家专项"
    }
  ]
}

返回字段说明

字段	类型	说明
total	number	总记录数
list	array	计划列表
list[].sid	number	学校ID
list[].major_id	number	专业ID
list[].year	number	年份
list[].province	string	省份
list[].school_name	string	学校名称
list[].spname	string	专业名称
list[].num	number	招生人数
list[].min	number	最低分
list[].min_section	number	最低位次
list[].local_batch_name	string	批次名称

注意事项

• 未传 plan_type 时，默认搜索所有专项计划（国家专项、地方专项、高校专项）
• keyword 仅对国家专项生效，要求 local_batch_name 包含"国家专项"且 school_name 或 spname 包含关键词
• 排序规则：min 升序，min 为 NULL 的记录排在最后