历年分数线图表

接口信息

• 接口名称：获取历年分数线图表数据
• 用途：获取院校历年分数线和位次趋势图数据，包括分数线趋势和位次变化
• 请求路径：POST /api/v1/charts/historical-scores-chart
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	必填	类型	说明	示例
year	否	string	年份，如"2024"或"近三年"	"2024"
batch	否	string	批次，默认"所有批次"	"本科批"
province	否	string	省份名称	"北京"
subject_type	否	string	科类：物理 / 历史 / 综合 / 艺术 / 体育	"物理"
keyword	否	string	院校/专业关键词，支持模糊匹配院校名称或专业名称	"清华大学"
limit	否	int	展示院校数量，默认3	3

批次枚举值

枚举值	说明
所有批次	不限制批次（默认）
本科提前批	匹配：本科提前批、本科提前批A段、本科提前批B段
本科批	匹配：本科批、本科一批、本科二批、本科三批、本科一段、本科二段
专科提前批	匹配：专科提前批
专科批	匹配：专科批、专科批A段
特殊类型招生	匹配：国家专项计划本科批、地方专项计划本科批、高校专项计划本科批

科类枚举值

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

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

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

返回结构

{
  "score_chart": [
    {
      "name": "院校名称",
      "data": [
        { "year": 2023, "value": 650 },
        { "year": 2024, "value": 655 }
      ]
    }
  ],
  "rank_chart": [
    {
      "name": "院校名称",
      "data": [
        { "year": 2023, "value": 3200 },
        { "year": 2024, "value": 3100 }
      ]
    }
  ]
}

字段说明

字段名	类型	说明
score_chart	array	分数线趋势图数据，每项对应一个院校，包含该院校各年份最低分
rank_chart	array	位次变化图数据，每项对应一个院校，包含该院校各年份最低位次
name	string	院校名称
data	array	历年数据数组，每个元素包含 year（年份）和 value（分数/位次）
year	int	年份
value	int	分数线（score_chart）或位次（rank_chart）

调用示例

请求示例

curl -X POST https://zytbapi.ncpjy.cn/api/v1/charts/historical-scores-chart \
  -H "Content-Type: application/json" \
  -d '{
    "year": "近三年",
    "batch": "本科批",
    "province": "北京",
    "subject_type": "物理",
    "keyword": "清华",
    "limit": 3
  }'

返回示例

{
  "score_chart": [
    {
      "name": "清华大学",
      "data": [
        { "year": 2023, "value": 688 },
        { "year": 2024, "value": 690 },
        { "year": 2025, "value": 692 }
      ]
    }
  ],
  "rank_chart": [
    {
      "name": "清华大学",
      "data": [
        { "year": 2023, "value": 256 },
        { "year": 2024, "value": 240 },
        { "year": 2025, "value": 230 }
      ]
    }
  ]
}

注意事项

1. 低于省控线的数据会被过滤。若未查询到对应省控线，默认使用 100 分作为阈值。
2. 结果按院校最低分升序排列，最终只返回前 limit 条院校数据。