院校详情 - 历年分数线列表

接口概述

• 接口地址：POST /api/v1/historical-scores-list
• 接口说明：查询院校历年分数线列表，支持多维度筛选与分页

请求参数

参数名	类型	必填	默认值	说明
year	string	否	-	年份，支持具体年份（如"2024"）或"近三年"
batch	string	否	"所有批次"	批次筛选，如"本科批"、"特殊类型招生"、"所有批次"
province	string	否	-	省份名称
subject_type	string	否	-	科类，如"物理"、"历史"、"综合"、"艺术"、"体育"
keyword	string	否	-	院校/专业关键词，同时匹配专业名称和学校名称

subject_type 与 batch 的可用值可通过动态接口获取：

• 科目：POST /api/v1/meta/subjects（source 传 "plans"）
• 批次：POST /api/v1/meta/batches（source 传 "plans"） | school_name | string | 否 | - | 院校名称精确筛选（列表头部筛选） | | page | number | 否 | 1 | 页码 | | limit | number | 否 | 10 | 每页数量 |

请求示例

{
  "year": "近三年",
  "batch": "本科批",
  "province": "江苏",
  "subject_type": "物理",
  "keyword": "计算机",
  "page": 1,
  "limit": 10
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 156,
    "page": 1,
    "limit": 10,
    "school_names": ["南京大学", "东南大学", "南京航空航天大学"],
    "list": [
      {
        "sid": 30,
        "spname": "计算机科学与技术",
        "year": 2024,
        "min": 650,
        "min_section": 3200,
        "average": 655,
        "batch": "本科批",
        "sg_infos": "",
        "plan_num": 45,
        "subject_type": "物理",
        "school_name": "南京大学",
        "hot": 1
      }
    ]
  }
}

返回字段说明

外层字段

字段名	类型	说明
total	number	总记录数
page	number	当前页码
limit	number	每页数量
school_names	string[]	符合条件的院校名称列表（用于下拉筛选）
list	array	分数线数据列表

list item 字段

字段名	类型	说明
sid	number	院校ID
spname	string	专业名称
year	number	年份
min	number	最低分
min_section	number	最低位次
average	number	平均分
batch	string	批次名称
sg_infos	string	选科要求信息
plan_num	number	招生计划人数
subject_type	string	科类
school_name	string	院校名称
hot	number	院校热度排序值

注意事项

1. school_name 参数可用于在院校详情页中精确筛选特定院校的历年分数线数据。
2. keyword 同时匹配专业名称和学校名称，两者为 AND 关系。
3. 查询结果按 year DESC → hot ASC → min ASC 排序。