艺术类招生分数线

接口概述

项目	内容
接口名称	获取艺术类/体育类招生分数线列表
请求方法	POST
接口路径	/api/v1/schools/fenshuxian-list
是否需要登录	否

请求参数

参数名	类型	必填	说明
year	string	否	年份，如 "2024"
province	string	是	省份，如 "江苏"、"北京" 等
category	string	否	类别，只能是 art（艺术类专业）或 sport（体育学院）
page	number	否	页码，默认 1
limit	number	否	每页数量，默认 10

返回结构

{
  "list": [
    {
      "sid": "123",
      "year": "2024",
      "kemu": "文科",
      "local_batch_name": "本科提前批",
      "min": 520,
      "province": "江苏",
      "proscore": 480,
      "min_section": 15000,
      "sg_info": "信息",
      "sg_name": "名称",
      "sp_code": "12345",
      "max_score": "-",
      "max_section": "-",
      "yx_zsfx": "某某艺术学院",
      "special_name": "音乐表演"
    }
  ],
  "total": 100,
  "page": 1,
  "limit": 10,
  "fl": "艺术类专业"
}

返回字段说明

字段	类型	说明
list	array	分数线数据列表
list[].sid	string	学校ID
list[].year	string	年份
list[].kemu	string	科目
list[].local_batch_name	string	本地批次名称
list[].min	number	最低分
list[].province	string	省份
list[].proscore	number	省控线
list[].min_section	number	最低位次
list[].sg_info	string	选考信息
list[].sg_name	string	选考名称
list[].sp_code	string	专业代码
list[].max_score	string	最高分（固定返回 "-"）
list[].max_section	string	最高位次（固定返回 "-"）
list[].yx_zsfx	string	院校名称
list[].special_name	string	专业名称
total	number	总记录数
page	number	当前页码
limit	number	每页数量
fl	string	类别名称（艺术类专业 / 体育学院）

调用示例

curl -X POST http://localhost:3666/api/v1/schools/fenshuxian-list \
  -H "Content-Type: application/json" \
  -d '{
    "year": "2024",
    "province": "江苏",
    "category": "art",
    "page": 1,
    "limit": 10
  }'

注意事项

• category 参数只能是 art 或 sport，传入其他值会返回 400 错误
• province 为必填参数，为空时返回 400 错误
• 返回字段保持与原始接口一致，使用 snake_case 命名