历年分数线列表

接口信息

• 接口名称：历年分数线列表
• 用途：获取院校专业历年分数线详细信息，支持多维度筛选（年份、批次、省份、科类、关键词、院校名称）
• 请求路径：/api/v1/historical-scores-list
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	必填	类型	说明	示例
year	否	string	年份筛选。支持具体年份（如"2024"）或"近三年"	"2024" / "近三年"
batch	否	string	批次筛选。枚举值见下方批次列表	"本科批"
province	否	string	省份名称	"北京"
subject_type	否	string	科类筛选。枚举值见下方科类映射	"物理"
keyword	否	string	院校/专业关键词。同时匹配专业名称和学校名称	"计算机"
school_name	否	string	院校名称精确筛选（列表头部下拉筛选）	"清华大学"
page	否	integer	页码，默认1	1
limit	否	integer	每页数量，默认10	10

批次枚举值

• 所有批次（不传或传此值则不筛选）
• 本科批
• 本科提前批
• 专科批
• 专科提前批
• 特殊类型招生（对应：国家专项、地方专项、强基计划、高校专项）

科类映射关系

subject_type	匹配科类值
物理	物理、物理类、理工、理科
历史	历史、历史类、文史、文科
综合	综合、综合类
艺术	书法类、戏剧影视导演、戏剧影视表演、播音与主持类、服装表演、美术与设计类、舞蹈类、音乐教育(器乐主项)、音乐教育(声乐主项)、音乐表演(器乐)、音乐表演(声乐)
体育	体育(文)、体育(理)

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

• 科目：POST /api/v1/meta/subjects（source 传 "plans"）
• 批次：POST /api/v1/meta/batches（source 传 "plans"）

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 100,
    "page": 1,
    "limit": 10,
    "list": [
      {
        "sid": 264,
        "spname": "计算机科学与技术",
        "year": 2024,
        "min": 669,
        "min_section": 54529,
        "average": 672,
        "batch": "本科批",
        "sg_infos": "物理+化学",
        "plan_num": 5,
        "subject_type": "物理",
        "school_name": "某某大学",
        "hot": 10
      }
    ],
    "school_names": ["某某大学", "某某学院"]
  }
}

返回字段说明

字段名	类型	说明
total	integer	去重后的总记录数
page	integer	当前页码
limit	integer	每页数量
list	array	数据列表
list[].sid	integer	学校ID
list[].spname	string	专业名称
list[].year	integer	年份
list[].min	integer	最低分
list[].min_section	integer	最低位次
list[].average	integer	平均分
list[].batch	string	批次名称
list[].sg_infos	string	选科要求
list[].plan_num	integer	计划招生数
list[].subject_type	string	科类
list[].school_name	string	学校名称
list[].hot	integer	学校热度
school_names	array	当前筛选条件下所有院校名称列表（用于前端下拉框）

调用示例

cURL

curl -X POST http://localhost:3666/api/v1/historical-scores-list \
  -H "Content-Type: application/json" \
  -d '{
    "year": "2024",
    "province": "北京",
    "subject_type": "物理",
    "keyword": "计算机",
    "page": 1,
    "limit": 10
  }'

JavaScript / TypeScript

const res = await fetch('/api/v1/historical-scores-list', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    year: '2024',
    province: '北京',
    subject_type: '物理',
    keyword: '计算机',
    page: 1,
    limit: 10,
  }),
});

const json = await res.json();
// json.data.list 为数据列表
// json.data.total 为总条数
// json.data.school_names 为院校名称下拉选项

注意事项

1. keyword 同时匹配专业名称和学校名称，两者为 AND 关系。
2. school_name 对学校表进行精确匹配。
3. 总数按 sid + spname + year 去重统计。
4. 查询结果按 year DESC → hot ASC → min ASC 排序。