特殊类型招生计划

接口概述

项目	内容
接口名称	获取专业计划列表（特殊类型招生）
请求方法	POST
接口路径	/api/v1/enrollment/special-plan
是否需要登录	否（登录且未传省份时自动补全用户省份）

请求参数

参数名	类型	必填	说明
year	number/string	否	年份，如2024
province	string	否	省份，如"江苏"；未传且登录时自动取用户省份
plan_type	number	否	计划类型：1=国家专项，2=地方专项，3=高校专项；不传则搜索所有专项计划
keyword	string	否	关键词搜索，仅对国家专项计划生效，搜索院校名称或专业名称
page	number	否	页码，默认1
limit	number	否	每页数量，默认10

返回结构

{
  "total": 100,
  "list": [
    {
      "sid": 123,
      "major_id": 456,
      "year": 2024,
      "province": "江苏",
      "school_name": "某大学",
      "spname": "计算机科学与技术",
      "num": 10,
      "min": 600,
      "min_section": 5000,
      "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	批次名称

调用示例

curl -X POST http://localhost:3666/api/v1/enrollment/special-plan \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "year": 2024,
    "province": "江苏",
    "plan_type": 1,
    "keyword": "计算机",
    "page": 1,
    "limit": 10
  }'

注意事项

• plan_type 有效值为 1、2、3，分别对应：国家专项、地方专项、高校专项
• 未传 plan_type 或传入无效值时，默认搜索所有三种专项计划
• keyword 关键词搜索仅对 国家专项 计划生效，会在 school_name 和 spname 字段中模糊匹配
• 查询结果按 min 字段升序排列，NULL 值排在最后