省控线列表查询

接口概述

项目	内容
接口名称	省控线列表查询
用途	查询各省历年省控线（批次分数线），支持多维度筛选与分页
接口路径	POST /api/v1/province-score-lines
请求方法	POST

请求参数

参数名	类型	必填	说明
province	string	否	省份名称，如"江苏"、"北京"
year	string	否	年份，如"2025"、"2024"
type_name	string	否	考生类别，如"物理类"、"历史类"、"理科"、"文科"
name	string	否	录取批次，如"本科批"、"专科批"
keyword	string	否	批次关键词搜索（模糊匹配批次名称）
is_use	number	否	是否启用：1-启用，0-未启用
page	number	否	当前页码，默认 1
pageSize	number	否	每页条数，默认 20

响应参数

参数名	类型	说明
code	number	状态码，200 表示成功
message	string	提示信息
data.items	object[]	省控线数据列表
data.items[].id	number	记录ID
data.items[].year	string	年份
data.items[].province	string	省份
data.items[].type_name	string	考生类别
data.items[].name	string	录取批次
data.items[].score	string	分数线
data.items[].major_score	string | null	专业分
data.items[].is_use	number	是否启用
data.total	number	总记录数
data.page	number	当前页码
data.pageSize	number	每页条数
data.totalPages	number	总页数
data.pagination	object	分页信息

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "items": [
      {
        "id": 3601,
        "year": "2025",
        "province": "云南",
        "type_name": "物理类",
        "name": "本科批",
        "score": "430",
        "major_score": null,
        "is_use": 1
      },
      {
        "id": 3603,
        "year": "2025",
        "province": "云南",
        "type_name": "物理类",
        "name": "特殊类型招生控制线",
        "score": "495",
        "major_score": null,
        "is_use": 0
      }
    ],
    "total": 7,
    "page": 1,
    "pageSize": 10,
    "totalPages": 1,
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 7,
      "totalPages": 1
    }
  }
}

调用示例

基础查询

curl -X POST http://localhost:3666/api/v1/province-score-lines \
  -H "Content-Type: application/json" \
  -d '{
    "province": "云南",
    "year": "2025",
    "page": 1,
    "pageSize": 10
  }'

多维度筛选

curl -X POST http://localhost:3666/api/v1/province-score-lines \
  -H "Content-Type: application/json" \
  -d '{
    "province": "云南",
    "year": "2025",
    "type_name": "物理类",
    "name": "本科批",
    "page": 1,
    "pageSize": 10
  }'

关键词搜索

curl -X POST http://localhost:3666/api/v1/province-score-lines \
  -H "Content-Type: application/json" \
  -d '{
    "province": "江苏",
    "year": "2024",
    "keyword": "艺术",
    "page": 1,
    "pageSize": 10
  }'

注意事项

• 批次字段很乱很多，建议先调用 POST /api/v1/meta/batches 接口，传入 source: "picixian" 获取当前省份+年份下实际有数据的批次列表，再作为 name 参数传入本接口。
• is_use 字段用于区分数据状态，但不同省份的标注逻辑可能不同，建议根据实际业务决定是否筛选。
• 返回结果按 year DESC、province ASC、type_name ASC、name ASC 排序。