位次查询历年数据

接口概述

项目	内容
接口名称	位次查询历年数据
请求方法	POST
接口路径	/api/v1/score-v2/history-scores

请求参数

参数名	类型	是否必填	默认值	说明
province	string	否	-	省份名称，如：北京
year	string	否	"2025"	年份
main_subject	string	否	-	主科目，如：物理、历史
sub_subjects	string / string[]	否	-	次科目，可以是字符串或字符串数组

主科目（main_subject）的可用值可通过 POST /api/v1/meta/subjects 接口动态获取，例如传入 { province, year, source: "yifenyiduan" }。 | select_type | string | 否 | "1" | 查询类型：1=分数查位次，2=位次查分数 | | score | string | 条件必填 | - | 分数，select_type=1 时必填 | | rank | string | 条件必填 | - | 位次，select_type=2 时必填 |

请求示例

分数查位次（select_type=1）

{
  "province": "北京",
  "year": "2025",
  "main_subject": "",
  "sub_subjects": "",
  "select_type": "1",
  "score": "600"
}

位次查分数（select_type=2）

{
  "province": "北京",
  "year": "2025",
  "main_subject": "",
  "sub_subjects": "",
  "select_type": "2",
  "rank": "11883"
}

响应参数

参数名	类型	说明
code	number	状态码，200 表示成功
message	string	提示信息
data	array	历年数据列表

data 数组项

参数名	类型	说明
year	number	年份
rank	number	位次
score	string	分数（可能为分数段，如 "700-750"）

响应示例

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "year": 2025,
      "rank": 11883,
      "score": "600"
    },
    {
      "year": 2024,
      "rank": 11883,
      "score": "594"
    },
    {
      "year": 2023,
      "rank": 11883,
      "score": "591"
    },
    {
      "year": 2022,
      "rank": 11883,
      "score": "578"
    },
    {
      "year": 2021,
      "rank": 11883,
      "score": "574"
    },
    {
      "year": 2020,
      "rank": 11883,
      "score": "583"
    }
  ]
}

错误码

状态码	说明
400	参数错误，如 score/rank 为空