历年招生人数筛选项

接口概述

项目	内容
接口名称	历年招生人数筛选项
用途	获取招生计划筛选所需的批次、年份和学校类型列表

---

获取筛选列表

请求路径

POST /api/v1/filter-list

请求方法

POST

请求参数

无

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "batch_list": [
      "所有批次",
      "本科批",
      "本科提前批",
      "专科批",
      "专科提前批",
      "特殊招生"
    ],
    "year_list": [
      "近五年",
      2024,
      2023,
      2022,
      2021,
      2020,
      2019,
      2018,
      2017
    ],
    "school_type_list": [
      "所有类型",
      "985",
      "211",
      "双一流",
      "普通本科",
      "专科(高职)"
    ]
  }
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data.batch_list	string[]	批次列表
data.year_list	(string | number)[]	年份列表，第一项为"近五年"，其余为具体年份
data.school_type_list	string[]	院校类型列表

batch_list 枚举值

值	说明
所有批次	默认选项，不限制批次
本科批	普通本科批次
本科提前批	本科提前录取批次
专科批	普通专科批次
专科提前批	专科提前录取批次
特殊招生	特殊类型招生

year_list 枚举值

值	说明
近五年	默认选项，查询近五年数据
2024	2024年
2023	2023年
2022	2022年
2021	2021年
2020	2020年
2019	2019年
2018	2018年
2017	2017年

school_type_list 枚举值

值	说明
所有类型	默认选项，不限制院校类型
985	985工程院校
211	211工程院校
双一流	双一流建设院校
普通本科	普通本科院校
专科(高职)	专科/高职院校

调用示例

curl -X POST http://localhost:3001/api/v1/filter-list \
  -H "Content-Type: application/json"

注意事项

• 该接口无需登录，支持匿名访问
• 返回的列表数据为写死配置，不涉及数据库查询
• 控制器直接返回数据，未进入服务层