热门专业分布

接口信息

• 接口名称：获取热门专业分布数据
• 接口用途：获取热门专业分布数据，包括各类专业数量统计和详细信息
• 请求路径：POST /api/v1/charts/hot-major-distribution
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	类型	必填	说明	示例
field	string	否	专业领域，默认"所有专业"	"所有专业"、"计算机类"

返回结构

接口返回标准统一响应格式：

{
  "code": 200,
  "message": "success",
  "data": {
    "chart_data": [
      {
        "name": "计算机类",
        "value": 15
      },
      {
        "name": "电子信息类",
        "value": 12
      }
    ],
    "category_details": {
      "计算机类": [
        {
          "major_name": "计算机科学与技术",
          "sp_code": "080901",
          "description": "",
          "school_count": 800,
          "level1_name": "工学",
          "level2_name": "计算机类",
          "level3_name": "计算机类"
        }
      ],
      "电子信息类": [
        {
          "major_name": "电子信息工程",
          "sp_code": "080701",
          "description": "",
          "school_count": 650,
          "level1_name": "工学",
          "level2_name": "电子信息类",
          "level3_name": "电子信息类"
        }
      ]
    }
  }
}

字段说明

chart_data 数组元素

字段名	类型	说明
name	string	三级分类名称（level3_name）
value	number	该分类下的专业数量

category_details 对象

键为三级分类名称（level3_name），值为该分类下的专业详情数组。

专业详情数组元素

字段名	类型	说明
major_name	string	专业名称
sp_code	string	专业代码
description	string	专业描述
school_count	number	开设院校数量
level1_name	string	一级学科门类名称
level2_name	string	二级学科类别名称
level3_name	string	三级学科分类名称

调用示例

请求示例 - 所有专业

curl -X POST https://api.example.com/api/v1/charts/hot-major-distribution \
  -H "Content-Type: application/json" \
  -d '{}'

请求示例 - 指定专业领域

curl -X POST https://api.example.com/api/v1/charts/hot-major-distribution \
  -H "Content-Type: application/json" \
  -d '{
    "field": "计算机类"
  }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "chart_data": [
      { "name": "计算机类", "value": 15 },
      { "name": "电子信息类", "value": 12 }
    ],
    "category_details": {
      "计算机类": [
        {
          "major_name": "计算机科学与技术",
          "sp_code": "080901",
          "description": "",
          "school_count": 800,
          "level1_name": "工学",
          "level2_name": "计算机类",
          "level3_name": "计算机类"
        }
      ]
    }
  }
}