all-project/docs/开发文档/API/招生统计API.md

招生统计API文档

接口概览

接口名称	接口路径	请求方式	接口说明
获取统计概览	/zsjy/statistics/overview	GET	获取招生统计数据概览
获取专业分布	/zsjy/statistics/major	GET	获取专业分布统计数据
获取地区分布	/zsjy/statistics/region	GET	获取地区分布统计数据
获取性别比例	/zsjy/statistics/gender	GET	获取性别比例统计数据
获取报名趋势	/zsjy/statistics/trend	GET	获取报名趋势统计数据
获取状态分布	/zsjy/statistics/status	GET	获取各状态分布统计数据

接口详细说明

1. 获取统计概览

接口地址：/zsjy/statistics/overview

请求方式：GET

权限要求：zsjy:statistics:overview

接口说明：获取招生统计数据概览，包括总报名人数、今日报名人数、缴费情况、录取情况以及各类分布数据。

请求参数：无

返回参数：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "totalEnrollments": 1050,           // 总报名人数
    "todayEnrollments": 25,             // 今日报名人数
    "paidCount": 850,                   // 已缴费人数
    "paymentRate": "80.95%",            // 缴费率
    "admittedCount": 750,               // 已录取人数
    "admissionRate": "71.43%",          // 录取率
    "majorDistribution": [              // 各专业报名人数分布
      {
        "name": "计算机科学与技术",
        "value": 350
      },
      {
        "name": "软件工程",
        "value": 280
      },
      // ...其他专业
    ],
    "regionDistribution": [             // 各地区报名人数分布
      {
        "name": "北京",
        "value": 150
      },
      {
        "name": "上海",
        "value": 120
      },
      // ...其他地区
    ],
    "genderRatio": {                    // 性别比例
      "M": 600,                         // 男生人数
      "F": 450                          // 女生人数
    },
    "weeklyTrend": [                    // 近7天报名趋势
      {
        "date": "2025-07-01",
        "count": 35
      },
      {
        "date": "2025-07-02",
        "count": 42
      },
      // ...其他日期
    ],
    "statusDistribution": {             // 各状态分布
      "0": 100,                         // 未开始
      "1": 200,                         // 信息审核中
      "2": 150,                         // 缴费确认中
      "3": 200,                         // 录取处理中
      "4": 100,                         // 最终审核中
      "5": 250,                         // 完成录取
      "6": 50                           // 退学
    }
  }
}

2. 获取专业分布

接口地址：/zsjy/statistics/major

请求方式：GET

权限要求：zsjy:statistics:major

接口说明：获取各专业报名人数分布统计数据。

请求参数：无

返回参数：

{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "name": "计算机科学与技术",
      "value": 350
    },
    {
      "name": "软件工程",
      "value": 280
    },
    {
      "name": "网络工程",
      "value": 150
    },
    {
      "name": "数据科学与大数据技术",
      "value": 180
    },
    {
      "name": "人工智能",
      "value": 90
    }
  ]
}

3. 获取地区分布

接口地址：/zsjy/statistics/region

请求方式：GET

权限要求：zsjy:statistics:region

接口说明：获取各地区报名人数分布统计数据。

请求参数：无

返回参数：

{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "name": "北京",
      "value": 150
    },
    {
      "name": "上海",
      "value": 120
    },
    {
      "name": "广东",
      "value": 180
    },
    {
      "name": "浙江",
      "value": 140
    },
    {
      "name": "江苏",
      "value": 130
    },
    {
      "name": "其他",
      "value": 330
    }
  ]
}

4. 获取性别比例

接口地址：/zsjy/statistics/gender

请求方式：GET

权限要求：zsjy:statistics:gender

接口说明：获取报名学生的性别比例统计数据。

请求参数：无

返回参数：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "M": 600,    // 男生人数
    "F": 450     // 女生人数
  }
}

5. 获取报名趋势

接口地址：/zsjy/statistics/trend

请求方式：GET

权限要求：zsjy:statistics:trend

接口说明：获取指定天数的报名趋势统计数据。

请求参数：

参数名	类型	是否必须	说明
days	Integer	否	查询天数，默认为7天

返回参数：

{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "date": "2025-07-01",
      "count": 35
    },
    {
      "date": "2025-07-02",
      "count": 42
    },
    {
      "date": "2025-07-03",
      "count": 28
    },
    {
      "date": "2025-07-04",
      "count": 36
    },
    {
      "date": "2025-07-05",
      "count": 25
    },
    {
      "date": "2025-07-06",
      "count": 18
    },
    {
      "date": "2025-07-07",
      "count": 30
    }
  ]
}

6. 获取状态分布

接口地址：/zsjy/statistics/status

请求方式：GET

权限要求：zsjy:statistics:status

接口说明：获取各状态的人数分布统计数据。

请求参数：无

返回参数：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "0": 100,    // 未开始
    "1": 200,    // 信息审核中
    "2": 150,    // 缴费确认中
    "3": 200,    // 录取处理中
    "4": 100,    // 最终审核中
    "5": 250,    // 完成录取
    "6": 50      // 退学
  }
}

状态码说明

状态码	说明
200	操作成功
401	未授权，请重新登录
403	没有权限，请联系管理员
500	服务器内部错误

数据字典

录取状态码

状态码	说明
0	未开始
1	信息审核中
2	缴费确认中
3	录取处理中
4	最终审核中
5	完成录取
6	退学
7	其他

性别代码

代码	说明
M	男
F	女