录取统计概览

接口概述

项目	内容
接口名称	录取统计概览
用途	提供高考录取相关的多维度统计数据，包括录取概览、招生计划趋势、专业类型分布、院校排名分布、数据概览等

---

1. 获取高考录取统计数据

请求路径

POST /api/v1/charts/admission-summary

请求方法

POST

请求参数

参数名	类型	是否必填	说明
year	number	否	年份，如 2024
province	string	否	省份名称，如"北京"
subject_type	string	否	选科类型（当前业务逻辑中未参与筛选）

subject_type 的可用值可通过动态接口获取：POST /api/v1/meta/subjects，source 传 "plans"。

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "total_applicants": 58000,
    "total_admitted": 50000,
    "undergrad_admitted": 32000,
    "college_admitted": 18000
  }
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data	object	录取统计数据
data.total_applicants	number	报名总人数
data.total_admitted	number	录取总人数
data.undergrad_admitted	number	本科录取人数
data.college_admitted	number	专科录取人数

调用示例

curl -X POST http://localhost:3666/api/v1/charts/admission-summary \
  -H "Content-Type: application/json" \
  -d '{"province":"北京","year":2024}'

---

2. 获取招生计划趋势数据

请求路径

POST /api/v1/charts/admission-plan-trend

请求方法

POST

请求参数

参数名	类型	是否必填	说明
province	string	否	省份，默认"北京"
school_name	string	否	院校名称，支持模糊搜索
major_name	string	否	专业名称，支持模糊搜索
batch_level	string	否	批次层级，如"本科批"
subject_type	string	否	科类，如"物理"
show_admitted	boolean	否	是否显示实际录取数据，默认false

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

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

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "years": [2020, 2021, 2022, 2023, 2024],
    "plan_data": [95000, 98000, 102000, 105000, 110000],
    "admitted_data": [92000, 96000, 100000, 103000, 108000]
  }
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data	object	趋势数据
data.years	array	年份列表
data.plan_data	array	各年招生计划人数
data.admitted_data	array	各年实际录取人数（仅当show_admitted为true时返回）

调用示例

curl -X POST http://localhost:3666/api/v1/charts/admission-plan-trend \
  -H "Content-Type: application/json" \
  -d '{"province":"北京","show_admitted":true}'

---

3. 获取专业类型分布数据

请求路径

POST /api/v1/charts/major-type-distribution

请求方法

POST

请求参数

参数名	类型	是否必填	说明
type	string	否	专业类型，默认"全部"。可选值：全部、哲学、经济学、法学、教育学、文学、历史学、理学、工学、农学、医学、管理学、艺术学

返回结构

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "type": "工学",
      "count": 320
    },
    {
      "type": "理学",
      "count": 150
    }
  ]
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data	array	专业类型分布列表
data[].type	string	专业类型名称
data[].count	number	该类型下的专业数量

调用示例

curl -X POST http://localhost:3666/api/v1/charts/major-type-distribution \
  -H "Content-Type: application/json" \
  -d '{"type":"全部"}'

---

4. 获取院校排名分布数据

请求路径

POST /api/v1/charts/school-ranking-distribution

请求方法

POST

请求参数

参数名	类型	是否必填	说明
type	string	否	排名类型，默认"软科排名"。可选值：软科排名、校友会排名、US世界排名、QS世界排名

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 150,
    "distribution": [
      {
        "name": "TOP 10",
        "value": 10,
        "percentage": 6.67,
        "schools": [
          {
            "sid": 1,
            "school_name": "清华大学",
            "school_name_en": "Tsinghua University",
            "rank": 1,
            "tags": "985,211",
            "total_score": 95.5
          }
        ]
      }
    ],
    "chart": {
      "title": {
        "text": "软科排名分布",
        "subtext": "共150所高校"
      },
      "tooltip": {
        "trigger": "item",
        "formatter": "{a} <br/>{b}: {c} ({d}%)"
      },
      "legend": {
        "orient": "vertical",
        "left": "left",
        "data": ["TOP 10", "TOP 50", "TOP 100", "TOP 200", "TOP 500"]
      },
      "series": [
        {
          "name": "排名分布",
          "type": "pie",
          "radius": ["50%", "70%"],
          "avoidLabelOverlap": false,
          "label": {
            "show": true,
            "formatter": "{b}: {c}所 ({d}%)"
          },
          "emphasis": {
            "label": {
              "show": true,
              "fontSize": "20",
              "fontWeight": "bold"
            }
          },
          "data": [
            {
              "name": "TOP 10",
              "value": 10,
              "percentage": 6.67
            }
          ]
        }
      ]
    }
  }
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data	object	排名分布数据
data.total	number	符合筛选条件的院校总数
data.distribution	array	各区间分布详情
data.distribution[].name	string	区间名称，如"TOP 10"
data.distribution[].value	number	该区间的院校数量
data.distribution[].percentage	number	占比（%）
data.distribution[].schools	array	区间内院校列表
data.distribution[].schools[].sid	number	院校ID
data.distribution[].schools[].school_name	string	院校名称
data.distribution[].schools[].school_name_en	string	院校英文名
data.distribution[].schools[].rank	number	排名
data.distribution[].schools[].tags	string	标签
data.distribution[].schools[].total_score	number	总分
data.chart	object	ECharts 图表配置数据

调用示例

curl -X POST http://localhost:3666/api/v1/charts/school-ranking-distribution \
  -H "Content-Type: application/json" \
  -d '{"type":"软科排名"}'

---

5. 获取数据概览信息

请求路径

POST /api/v1/charts/data-overview

请求方法

POST

请求参数

无

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "school_count": {
      "value": "3,005",
      "increase": 12
    },
    "major_count": {
      "value": "1,234",
      "increase": 46
    },
    "year_data": {
      "value": "5年",
      "increase": "+1年"
    },
    "update_info": {
      "type": "实时",
      "time": "每日"
    }
  }
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data	object	数据概览
data.school_count	object	收录院校数量
data.school_count.value	string	院校数量（带千位分隔符）
data.school_count.increase	number	较上月新增
data.major_count	object	专业数量
data.major_count.value	string	专业数量（带千位分隔符）
data.major_count.increase	number	较上月新增
data.year_data	object	历年数据
data.year_data.value	string	数据覆盖年份
data.year_data.increase	string	数据更新标识
data.update_info	object	更新信息
data.update_info.type	string	更新类型
data.update_info.time	string	更新频率

调用示例

curl -X POST http://localhost:3666/api/v1/charts/data-overview \
  -H "Content-Type: application/json"