动态批次枚举查询

接口概述

项目	内容
接口名称	动态批次枚举查询
用途	根据省份+年份+数据来源，动态获取实际有数据的批次枚举值
接口路径	POST /api/v1/meta/batches
请求方法	POST

请求参数

参数名	类型	必填	说明
province	string	是	省份名称，如"江苏"、"北京"
year	string / number	否	年份，如"2025"、2024
source	string	是	数据来源标识，见下方来源映射表

source 来源映射表

source 值	适用场景
plans	历年招生人数、历年分数线、院校详情、冲稳保
plans_2024	2024招生计划
batch_policy	招生批次政策
yifenyiduan	一分一段表
yifenyiduan_2025	一分一段表（2025新表）
zhuanyefenshu	院校专业分数线测试表

响应参数

参数名	类型	说明
code	number	状态码，200 表示成功
message	string	提示信息
data	string[]	该省份+年份+数据来源下实际有数据的批次列表，按字母升序排列

响应示例

{
  "code": 200,
  "message": "success",
  "data": [
    "本科批",
    "本科提前批",
    "专科批",
    "专科提前批"
  ]
}

调用示例

curl -X POST http://localhost:3666/api/v1/meta/batches \
  -H "Content-Type: application/json" \
  -d '{
    "province": "江苏",
    "year": 2025,
    "source": "plans"
  }'

注意事项

• 该接口查询的是数据库中实际存在数据的批次值，非写死配置。
• 不同年份、省份对应的批次体系可能不同（如老高考可能分本科一批/二批，新高考合并为本科批）。
• 返回结果已去重、过滤空值，并按字母升序排列。
• 当 year 为空时，不限制年份条件，返回该省份所有年份的去重批次。