录取分类统计

接口概述

项目	内容
接口名称	录取分类统计
用途	按 province、year、subject_type 返回分类报名与录取统计

---

1. 获取分类统计数据

请求路径

POST /api/v1/charts/category-stats

请求方法

POST

请求参数

参数名	类型	是否必填	说明
province	string	是	省份名称，如"北京"
year	number	是	年份，如 2024
subject_type	string	是	科类，如"物理类"、"历史类"

枚举值说明

subject_type 常见取值：

• 物理类
• 历史类
• 理科
• 文科
• 综合

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

返回结构

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "title": "报名人数",
      "total_applicants": 58000,
      "undergrad_admitted": 32000,
      "college_admitted": 18000
    }
  ]
}

返回字段说明

字段路径	类型	说明
code	number	状态码，200为成功
message	string	提示信息
data	array	分类统计数据列表
data[].title	string	统计项标题
data[].total_applicants	number	报名人数
data[].undergrad_admitted	number	本科录取人数
data[].college_admitted	number	专科录取人数

调用示例

curl -X POST http://localhost:3666/api/v1/charts/category-stats \
  -H "Content-Type: application/json" \
  -d '{"province":"北京","year":2024,"subject_type":"物理类"}'

注意事项

• 接口返回的是数组形式，每一项对应一条分类统计记录
• 若查询不到数据，返回空数组 []