历年招生人数列表

接口概述

项目	内容
接口名称	历年招生人数列表
用途	根据年份、省份、院校类型、批次等条件查询院校招生计划列表，支持分页

---

获取历年招生人数列表

请求路径

POST /api/v1/get-school-plan

请求方法

POST

请求参数

参数名	必填	类型	说明	枚举值/示例
year	否	string	年份，默认2024	"近五年", "2024", "2023", "2022", "2021", "2020", "2019", "2018", "2017"
province	否	string	省份，默认不限	"all"（全部），"cur"（当前省份，默认江苏），或其他省份名称如 "江苏"
school_type	否	string	院校类型，默认不限	"985", "211", "双一流", "普通本科", "专科(高职)"
batch	否	string	批次等级，默认不限	"all"（全部），"本科批", "本科提前批", "专科批", "专科提前批", "特殊类型招生"
page	否	number	页码，默认1	1, 2, 3...
limit	否	number	每页数量，默认10	10, 20, 50...

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "id": 1,
        "sid": 123,
        "year": 2024,
        "province": "江苏",
        "kemu": "物理",
        "spname": "计算机科学与技术",
        "batch_name": "本科批",
        "local_batch_name": "本科批",
        "average": 600,
        "min": 590,
        "min_section": 5000,
        "sg_infos": "物理+化学",
        "spcode": "080901",
        "local_name": 1,
        "sg_name": "普通类",
        "tb_sn_code": "...",
        "tb_sg_code": "...",
        "major_id": 12345,
        "spdetail": "工学",
        "num": 50,
        "length": "4年",
        "tuition": 5800,
        "nature_name": "公办",
        "f985": 985,
        "f211": 211,
        "school_name": "某某大学",
        "type_name": "综合",
        "logo": "...",
        "level_name": "普通本科",
        "sg_options": "物理,化学",
        "city": "南京",
        "job_id": 1,
        "average_section": null,
        "max": null,
        "max_section": null,
        "created_at": "2024-01-01T00:00:00.000Z",
        "updated_at": "2024-01-01T00:00:00.000Z"
      }
    ],
    "total": 100,
    "page": 1,
    "limit": 10
  }
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data.list	object[]	招生计划数据列表
data.list[].id	number	记录ID
data.list[].sid	number | null	学校ID
data.list[].year	number | null	年份
data.list[].province	string | null	省份
data.list[].kemu	string | null	科目
data.list[].spname	string | null	专业名称
data.list[].batch_name	string | null	批次名称
data.list[].local_batch_name	string | null	本地批次名称
data.list[].average	number | null	平均分
data.list[].min	number | null	最低分
data.list[].min_section	number | null	最低位次
data.list[].sg_infos	string | null	选科信息
data.list[].spcode	string | null	专业代码
data.list[].num	number	计划招生人数（-1表示未知）
data.list[].length	string | null	学制
data.list[].tuition	number | null	学费
data.list[].nature_name	string | null	办学性质
data.list[].f985	number | null	985标识（985表示是）
data.list[].f211	number | null	211标识（211表示是）
data.list[].school_name	string | null	学校名称
data.list[].type_name	string | null	学校类型
data.list[].logo	string | null	学校Logo
data.list[].level_name	string | null	层次名称
data.list[].city	string | null	城市
data.total	number	总记录数
data.page	number	当前页码
data.limit	number	每页数量

school_type 枚举值说明

值	查询逻辑
985	f985 = 985
211	f211 = 211
双一流	f985 = 985 且 f211 = 211
普通本科	level_name = '普通本科'
专科(高职)	level_name = '专科（高职）'

batch 枚举值说明

值	查询逻辑
all	不限制批次
本科批	batch_name = '本科批'
本科提前批	batch_name = '本科提前批'
专科批	batch_name = '专科批'
专科提前批	batch_name = '专科提前批'
特殊类型招生	batch_name IN ['国家专项', '地方专项', '强基计划', '高校专项']

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

调用示例

请求：

curl -X POST http://localhost:3001/api/v1/get-school-plan \
  -H "Content-Type: application/json" \
  -d '{
    "year": "2024",
    "province": "江苏",
    "school_type": "985",
    "batch": "本科批",
    "page": 1,
    "limit": 10
  }'

响应：

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [...],
    "total": 25,
    "page": 1,
    "limit": 10
  }
}

注意事项

• 该接口无需登录，支持匿名访问
• year 不传时默认查询 2024 年数据
• year 传 "近五年" 时，按 year >= 当前年份 - 5 查询，且结果优先按年份倒序、再按最低分升序排列
• 非近五年查询时，结果按 min（最低分）升序排列
• province 传 "cur" 时，内部会替换为 "江苏"
• 所有参数均为可选，空参数表示不限制该条件