专业就业率

接口概述

专业就业数据分析接口，提供就业率统计、薪资分析、就业方向、就业趋势等数据。

请求路径

/api/v1/majors/employment

请求方法

POST

请求参数

参数名	类型	必填	说明
cate1	string	否	学科门类，如"工学"、"理学"等
degree	string	否	学位层次，默认"本科"，可选"本科"/"专科"
major_name	string	否	专业名称，模糊搜索
page	string	否	页码，默认"1"
page_size	string	否	每页数量，默认"10"，最大50
sort_type	string	否	排序方式，默认employment_rate_desc
trend_major	string	否	趋势分析中选中的专业名称

sort_type 枚举值

值	说明
employment_rate_desc	就业率高到低（默认）
employment_rate_asc	就业率低到高
satisfaction_desc	满意度高到低
satisfaction_asc	满意度低到高
salary_desc	平均起薪高到低
salary_asc	平均起薪低到高

返回结构

{
  "employment_rate": {
    "value": "86.5%",
    "degree": "本科",
    "year": 2024
  },
  "average_salary": {
    "value": 6500,
    "degree": "本科",
    "year": 2024
  },
  "satisfaction": {
    "value": "78%",
    "degree": "本科",
    "year": 2024
  },
  "high_salary_majors": {
    "majors": ["信息安全", "软件工程"],
    "min_salary": 8000
  },
  "ranking_list": {
    "total": 100,
    "page": 1,
    "page_size": 10,
    "list": [
      {
        "rank": 1,
        "major_name": "软件工程",
        "discipline": "工学",
        "employment_rate": "95%",
        "initial_salary": "￥8000",
        "satisfaction": "85%",
        "major_id": 123
      }
    ]
  },
  "salary_analysis": {
    "salary_compare": [
      { "discipline": "工学", "salary": 7000 }
    ],
    "salary_growth": {
      "title": "工学",
      "growth_data": [
        {
          "time": "毕业半年",
          "avg_salary": 6500,
          "salary_range": { "min": 4000, "max": 9000 }
        },
        {
          "time": "毕业三年",
          "avg_salary": 9000,
          "salary_range": { "min": 6000, "max": 12000 }
        },
        {
          "time": "毕业五年",
          "avg_salary": 12000,
          "salary_range": { "min": 8000, "max": 16000 }
        }
      ]
    }
  },
  "employment_direction": {
    "title": "软件工程",
    "industry_distribution": [
      { "name": "互联网", "percentage": "30%", "avg_salary": "￥10000" }
    ],
    "position_distribution": [
      { "name": "后端开发", "percentage": "20%" }
    ],
    "career_analysis": {
      "major": {
        "name": "软件工程",
        "industry": [{ "name": "互联网", "percentage": "30%" }],
        "position": [{ "name": "后端开发", "percentage": "20%" }]
      }
    }
  },
  "employment_trend": {
    "major_options": ["软件工程", "计算机科学与技术"],
    "selected_major": "软件工程",
    "trend_data": [
      { "year": 2022, "major_name": "软件工程", "employment_rate": 92.5, "avg_salary": 7500 }
    ],
    "trend_analysis": {
      "market_demand": "增长",
      "competition_level": "中等"
    }
  }
}

返回字段说明

字段	类型	说明
employment_rate.value	string	就业率，默认"86.5%"
average_salary.value	number	平均起薪
satisfaction.value	string	满意度百分比
high_salary_majors.majors	string[]	高薪专业名称列表
high_salary_majors.min_salary	number	高薪专业平均起薪
ranking_list.total	number	排名列表总数
ranking_list.page	number	当前页码
ranking_list.page_size	number	每页数量
ranking_list.list	array	就业率排名列表
list[].rank	number	排名
list[].major_name	string	专业名称
list[].discipline	string	学科门类
list[].employment_rate	string	就业率
list[].initial_salary	string	平均起薪
list[].satisfaction	string	满意度
list[].major_id	number	专业ID
salary_analysis.salary_compare	array	各学科起薪对比
salary_analysis.salary_growth	object	薪资增长趋势
employment_direction.industry_distribution	array	行业分布
employment_direction.position_distribution	array	职位分布
employment_trend.major_options	string[]	趋势下拉选项
employment_trend.selected_major	string	当前选中的专业
employment_trend.trend_data	array	历年趋势数据
employment_trend.trend_analysis	object	趋势分析

调用示例

curl -X POST http://localhost:3666/api/v1/majors/employment \
  -H "Content-Type: application/json" \
  -d '{
    "cate1": "工学",
    "degree": "本科",
    "page": "1",
    "page_size": "10",
    "sort_type": "employment_rate_desc"
  }'

注意事项

• 默认查询去年（当前年份 - 1）的数据
• 如无数据，平均起薪默认6500，满意度默认78%，高薪专业默认["信息安全", "软件工程"]