预见猿份

项目接口文档 ​

部门管理 ​

部门列表查询 ​

基本信息 ​

请求路径：/depts

请求方式：GET

接口描述：该接口用于部门列表数据查询

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

参数名类型是否必须备注
codenumber必须响应码，1 代表成功，0 代表失败
msgstring非必须提示信息
dataobject[]非必须返回的数据
└─ data.idnumber非必须id
└─ data.namestring非必须部门名称
└─ data.createTimestring非必须创建时间
└─ data.updateTimestring非必须修改时间

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "name": "学工部",
      "createTime": "2022-09-01T23:06:29",
      "updateTime": "2022-09-01T23:06:29"
    },
    {
      "id": 2,
      "name": "教研部",
      "createTime": "2022-09-01T23:06:29",
      "updateTime": "2022-09-01T23:06:29"
    }
  ]
}

删除部门 ​

基本信息 ​

请求路径：/depts

请求方式：DELETE

接口描述：该接口用于根据ID删除部门数据

请求参数 ​

参数说明：

参数名类型是否必须备注
idnumber必须部门ID

请求参数样例：

/depts?id=1

/depts?id=2

响应数据 ​

参数格式：application/json

参数说明：

参数名类型是否必须备注
codenumber必须响应码，1 代表成功，0 代表失败
msgstring非必须提示信息
dataobject非必须返回的数据

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

添加部门 ​

基本信息 ​

请求路径：/depts

请求方式：POST

接口描述：该接口用于添加部门数据

请求参数 ​

格式：application/json

参数说明：

请求参数样例：

JSON
{
    "name": "教研部"
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

根据ID查询 ​

基本信息 ​

请求路径：/depts/{id}

请求方式：GET

接口描述：该接口用于根据ID查询部门数据

请求参数 ​

参数格式：路径参数

参数说明：

请求参数样例：

/depts/1

/depts/3

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "id": 1,
    "name": "学工部",
    "createTime": "2022-09-01T23:06:29",
    "updateTime": "2022-09-01T23:06:29"
  }
}

修改部门 ​

基本信息 ​

请求路径：/depts

请求方式：PUT

接口描述：该接口用于修改部门数据

请求参数 ​

格式：application/json

参数说明：

请求参数样例：

JSON
{
    "id": 1,
    "name": "教研部"
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

员工管理 ​

员工列表查询 ​

基本信息 ​

请求路径：/emps

请求方式：GET

接口描述：该接口用于员工列表数据的条件分页查询

请求参数 ​

参数格式：queryString

参数说明：

请求数据样例：

/emps?name=张&gender=1&begin=2007-09-01&end=2022-09-01&page=1&pageSize=10

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "total": 2,
    "rows": [
       {
        "id": 1,
        "username": "jinyong",
        "password": "123456",
        "name": "金庸",
        "gender": 1,
        "image": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-53B.jpg",
        "job": 2,
        "salary": 8000,
        "entryDate": "2015-01-01",
        "deptId": 2,
        "deptName": "教研部",
        "createTime": "2022-09-01T23:06:30",
        "updateTime": "2022-09-02T00:29:04"
      },
      {
        "id": 2,
        "username": "zhangwuji",
        "password": "123456",
        "name": "张无忌",
        "gender": 1,
        "image": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-53B.jpg",
        "job": 2,
        "salary": 6000,
        "entryDate": "2015-01-01",
        "deptId": 2,
        "deptName": "教研部",
        "createTime": "2022-09-01T23:06:30",
        "updateTime": "2022-09-02T00:29:04"
      }
    ]
  }
}

删除员工 ​

基本信息 ​

请求路径：/emps

请求方式：DELETE

接口描述：该接口用于批量删除员工的数据信息

请求参数 ​

参数格式：查询参数

参数说明：

请求参数样例：/emps?ids=1,2,3

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

添加员工 ​

基本信息 ​

请求路径：/emps

请求方式：POST

接口描述：该接口用于添加员工的信息

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
  "image": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-03-07-37-38222.jpg",
  "username": "linpingzhi",
  "name": "林平之",
  "gender": 1,
  "job": 1,
  "entryDate": "2022-09-18",
  "deptId": 1,
  "phone": "18809091234",
  "salary": 8000,
  "exprList": [
      {
         "company": "百度科技股份有限公司",
         "job": "java开发",
         "begin": "2012-07-01",
         "end": "2019-03-03"
      },
      {
         "company": "阿里巴巴科技股份有限公司",
         "job": "架构师",
         "begin": "2019-03-15",
         "end": "2023-03-01"
      }
   ]
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

根据ID查询 ​

基本信息 ​

请求路径：/emps/{id}

请求方式：GET

接口描述：该接口用于根据主键ID查询员工的信息

请求参数 ​

参数格式：路径参数

参数说明：

请求参数样例：/emps/1

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "id": 2,
    "username": "zhangwuji",
    "password": "123456",
    "name": "张无忌",
    "gender": 1,
    "image": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-53B.jpg",
    "job": 2,
    "salary": 8000,
    "entryDate": "2015-01-01",
    "deptId": 2,
    "createTime": "2022-09-01T23:06:30",
    "updateTime": "2022-09-02T00:29:04",
    "exprList": [
      {
        "id": 1,
        "begin": "2012-07-01",
        "end": "2019-03-03"
        "company": "百度科技股份有限公司"
        "job": "java开发",
        "empId": 2
      },
      {
        "id": 2,
        "begin": "2019-3-15",
        "end": "2023-03-01"
        "company": "阿里巴巴科技股份有限公司"
        "job": "架构师",
        "empId": 2
      }
    ]
  }
}

修改员工 ​

基本信息 ​

请求路径：/emps

请求方式：PUT

接口描述：该接口用于修改员工的数据信息

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
    "id": 2,
    "username": "zhangwuji",
    "password": "123456",
    "name": "张无忌",
    "gender": 1,
    "image": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-53B.jpg",
    "job": 2,
    "salary": 8000,
    "entryDate": "2015-01-01",
    "deptId": 2,
    "createTime": "2022-09-01T23:06:30",
    "updateTime": "2022-09-02T00:29:04",
    "exprList": [
      {
        "id": 1,
        "begin": "2012-07-01",
        "end": "2015-06-20"
        "company": "中软国际股份有限公司"
        "job": "java开发",
        "empId": 2
      },
      {
        "id": 2,
        "begin": "2015-07-01",
        "end": "2019-03-03"
        "company": "百度科技股份有限公司"
        "job": "java开发",
        "empId": 2
      },
      {
        "id": 3,
        "begin": "2019-3-15",
        "end": "2023-03-01"
        "company": "阿里巴巴科技股份有限公司"
        "job": "架构师",
        "empId": 2
      }
    ]
  }

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

查询全部员工 ​

基本信息 ​

请求路径：/emps/list

请求方式：GET

接口描述：该接口用于查询全部员工信息

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": [
    {
      "id": 21,
      "username": "zcc",
      "password": "123456",
      "name": "周星驰",
      "gender": 1,
      "image": "https://web-65.oss-cn-beijing.aliyuncs.com/99c143e9-0241-41f3-bc55-dd5e4e0824f4.jpg",
      "job": 1,
      "salary": 8000,
      "entryDate": "2023-04-23",
      "deptId": 2,
      "createTime": "2023-05-26T17:25:01",
      "updateTime": "2023-06-04T19:25:15"
    },
    {
      "id": 6,
      "username": "xiaozhao",
      "password": "123456",
      "name": "小昭",
      "gender": 2,
      "image": "https://web-65.oss-cn-beijing.aliyuncs.com/da94dc38-f165-480c-b8b7-0b3f4bcd1602.jpg",
      "job": 3,
      "salary": 8000,
      "entryDate": "2013-09-05",
      "deptId": 1,
      "createTime": "2023-04-07T11:16:00",
      "updateTime": "2023-04-14T08:22:41"
    }
  ]
}

班级管理 ​

班级列表查询 ​

基本信息 ​

请求路径：/clazzs

请求方式：GET

接口描述：该接口用于班级列表数据的条件分页查询

请求参数 ​

参数格式：queryString

参数说明：

请求数据样例：/clazzs?name=java&begin=2023-01-01&end=2023-06-30&page=1&pageSize=5

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "total": 6,
    "rows": [
      {
        "id": 7,
        "name": "黄埔四期",
        "room": "209",
        "beginDate": "2023-08-01",
        "endDate": "2024-02-15",
        "masterId": 7,
        "createTime": "2023-06-01T17:51:21",
        "updateTime": "2023-06-01T17:51:21",
        "masterName": "纪晓芙",
        "status": "已开班"
      },
      {
        "id": 6,
        "name": "JavaEE就业166期",
        "room": "105",
        "beginDate": "2023-07-20",
        "endDate": "2024-02-20",
        "masterId": 20,
        "createTime": "2023-06-01T17:46:10",
        "updateTime": "2023-06-01T17:46:10",
        "masterName": "陈友谅",
        "status": "未开班"
      }
    ]
  }
}

删除班级 ​

基本信息 ​

请求路径：/clazzs/{id}

请求方式：DELETE

接口描述：该接口用于删除班级信息

请求参数 ​

参数格式：路径参数

参数说明：

请求参数样例：/clazzs/5

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

添加班级 ​

基本信息 ​

请求路径：/clazzs

请求方式：POST

接口描述：该接口用于添加班级信息

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
  "name": "JavaEE就业166期",
  "room": "101",
  "beginDate": "2023-06-01",
  "endDate": "2024-01-25",
  "masterId": 7,
  "subject": 1
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

根据ID查询 ​

基本信息 ​

请求路径：/clazzs/{id}

请求方式：GET

接口描述：该接口用于根据主键ID查询班级的信息

请求参数 ​

参数格式：路径参数

参数说明：

请求参数样例：/clazzs/8

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "id": 8,
    "name": "JavaEE就业166期",
    "room": "101",
    "beginDate": "2023-06-01",
    "endDate": "2024-01-25",
    "masterId": 7,
    "subject": 1,
    "createTime": "2023-06-04T17:37:45",
    "updateTime": "2023-06-04T17:37:45"
  }
}

修改班级 ​

基本信息 ​

请求路径：/clazzs

请求方式：PUT

接口描述：该接口用于修改班级的数据信息

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
  "id": 8,
  "name": "JavaEE就业166期",
  "room": "101",
  "beginDate": "2023-06-01",
  "endDate": "2024-01-25",
  "masterId": 7,
  "subject": 1
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

查询所有班级 ​

基本信息 ​

请求路径：/clazzs/list

请求方式：GET

接口描述：该接口用于查询所有班级信息

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data":[
      {
        "id": 7,
        "name": "黄埔四期",
        "room": "209",
        "beginDate": "2023-08-01",
        "endDate": "2024-02-15",
        "masterId": 7,
        "subject": 1,
        "createTime": "2023-06-01T17:51:21",
        "updateTime": "2023-06-01T17:51:21"
      },
      {
        "id": 6,
        "name": "JavaEE就业166期",
        "room": "105",
        "beginDate": "2023-07-20",
        "endDate": "2024-02-20",
        "masterId": 20,
        "subject": 1,
        "createTime": "2023-06-01T17:46:10",
        "updateTime": "2023-06-01T17:46:10"
      }
    ]
}

学员管理 ​

学员列表查询 ​

基本信息 ​

请求路径：/students

请求方式：GET

接口描述：该接口用于学员列表数据的条件分页查询

请求参数 ​

参数格式：queryString

参数说明：

请求数据样例：/students?name=张三&degree=1&clazzId=2&page=1&pageSize=5

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "total": 5,
    "rows": [
      {
        "id": 3,
        "name": "Lily",
        "no": "2023001003",
        "gender": 2,
        "phone": "13309230912",
        "degree": 4,
        "idCard": "110090110090110090",
        "isCollege": 0,
        "address": "回龙观东大街110号",
        "graduationDate": "2020-07-01",
        "violationCount": 2,
        "violationScore": 5,
        "clazzId": 1,
        "createTime": "2023-06-01T18:35:23",
        "updateTime": "2023-06-01T19:37:42",
        "clazzName": "黄埔班一期"
      },
      {
        "id": 4,
        "name": "Jerry",
        "no": "2023001004",
        "gender": 1,
        "phone": "15309232323",
        "degree": 4,
        "idCard": "110090110090110090",
        "isCollege": 0,
        "address": "回龙观东大街110号",
        "graduationDate": "2020-07-01",
        "violationCount": 1,
        "violationScore": 2,
        "clazzId": 1,
        "createTime": "2023-06-01T18:35:48",
        "updateTime": "2023-06-01T19:37:35",
        "clazzName": "黄埔班一期"
      }
    ]
  }
}

删除学员 ​

基本信息 ​

请求路径：/students/{ids}

请求方式：DELETE

接口描述：该接口用于批量删除学员信息

请求参数 ​

参数格式：路径参数

参数说明：

请求参数样例：/students/1,2,3

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

添加学员 ​

基本信息 ​

请求路径：/students

请求方式：POST

接口描述：该接口用于添加学员信息

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
    "name": "阿大",
    "no": "2024010801",
    "gender": 1,
    "phone": "15909091235",
    "idCard": "159090912351590909",
    "isCollege": 1,
    "address": "昌平回龙观",
    "degree": 4,
    "graduationDate": "2024-01-01",
    "clazzId": 9
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

根据ID查询 ​

基本信息 ​

请求路径：/students/{id}

请求方式：GET

接口描述：该接口用于根据主键ID查询学员的信息

请求参数 ​

参数格式：路径参数

参数说明：

请求参数样例：/students/8

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "id": 7,
    "name": "Locos",
    "no": "2023001010",
    "gender": 1,
    "phone": "13712345678",
    "degree": 5,
    "idCard": "110090110090110090",
    "isCollege": 0,
    "address": "回龙观东大街110号",
    "graduationDate": "2020-07-01",
    "violationCount": 0,
    "violationScore": 0,
    "clazzId": 2,
    "createTime": "2023-06-04T18:27:27",
    "updateTime": "2023-06-04T18:27:27"
  }
}

修改学员 ​

基本信息 ​

请求路径：/students

请求方式：PUT

接口描述：该接口用于修改学员的数据信息

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
  "id": 7,
  "name": "Locos",
  "no": "2023001010",
  "gender": 1,
  "phone": "13712345678",
  "degree": 5,
  "idCard": "110090110090110090",
  "isCollege": 0,
  "address": "回龙观东大街110号",
  "graduationDate": "2020-07-01",
  "violationCount": 0,
  "violationScore": 0,
  "clazzId": 2
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

违纪处理 ​

基本信息 ​

请求路径：/students/violation/{id}/{score}

请求方式：PUT

接口描述：该接口用于修改学员的数据信息

请求参数 ​

参数格式：路径参数

参数说明：

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code":1,
    "msg":"success",
    "data":null
}

数据统计 ​

员工性别统计 ​

基本信息 ​

请求路径：/report/empGenderData

请求方式：GET

接口描述：统计员工性别信息

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": [
    {"name": "男性员工","value": 5},
    {"name": "女性员工","value": 6}
  ]
}

员工职位人数统计 ​

基本信息 ​

请求路径：/report/empJobData

请求方式：GET

接口描述：统计各个职位的员工人数

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "jobList": ["教研主管","学工主管","其他","班主任","咨询师","讲师"],
    "dataList": [1,1,2,6,8,13]
  }
}

学员学历统计 ​

基本信息 ​

请求路径：/report/studentDegreeData

请求方式：GET

接口描述：统计学员的学历信息

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": [
    {
      "name": "初中",
      "value": 5
    },
    {
      "name": "高中",
      "value": 6
    },
    {
      "name": "大专",
      "value": 126
    },
    {
      "name": "本科",
      "value": 182
    },
    {
      "name": "硕士",
      "value": 6
    }
  ]
}

班级人数统计 ​

基本信息 ​

请求路径：/report/studentCountData

请求方式：GET

接口描述：统计每一个班级的人数

请求参数 ​

无

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
  "code": 1,
  "msg": "success",
  "data": {
    "clazzList": ["Java就业100期","Java就业101期","Java就业102期","Java就业103期","Java就业104期"],
    "dataList": [77,82,70,80,90]
  }
}

日志列表查询 ​

基本信息 ​

请求路径：/log/page

请求方式：GET

接口描述：该接口用于日志信息的分页查询

请求参数 ​

参数格式：queryString

参数说明：

请求数据样例：/log/page?page=1&pageSize=10

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code": 1,
    "msg": null,
    "data": {
        "total": 15,
        "rows": [
            {
                "id": 15,
                "operateEmpId": 2,
                "operateTime": "2023-12-18T17:37:15",
                "className": "com.itheima.controller.DeptController",
                "methodName": "add",
                "methodParams": "[Dept(id=null, name=投资部, createTime=null, updateTime=null)]",
                "returnValue": "Result(code=1, msg=null, data=null)",
                "costTime": 8,
                "operateEmpName": "宋江"
            },
            {
                "id": 14,
                "operateEmpId": 2,
                "operateTime": "2023-12-18T17:37:07",
                "className": "com.itheima.controller.DeptController",
                "methodName": "add",
                "methodParams": "[Dept(id=null, name=市场部, createTime=null, updateTime=null)]",
                "returnValue": "Result(code=1, msg=null, data=null)",
                "costTime": 4,
                "operateEmpName": "宋江"
            }
        ]
    }
}

其他接口 ​

登录 ​

基本信息 ​

请求路径：/login

请求方式：POST

接口描述：该接口用于员工登录Tlias智能学习辅助系统，登录完毕后，系统下发JWT令牌。

请求参数 ​

参数格式：application/json

参数说明：

请求数据样例：

JSON
{
    "username": "jinyong",
    "password": "123456"
}

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code": 1,
    "msg": "success",
    "data": {
        "id": 2,
        "username": "songjiang",
        "name": "宋江",
        "token": "eyJhbGciOiJIUzI1NiJ9.eyJpZCI6MiwidXNlcm5hbWUiOiJzb25namlhbmciLCJleHAiOjE2OTg3MDE3NjJ9.w06EkRXTep6SrvMns3w5RKe79nxauDe7fdMhBLK-MKY"
    }
}

备注说明 ​

用户登录成功后，系统会自动下发JWT令牌，然后在后续的每次请求中，都需要在请求头header中携带到服务端，请求头的名称为 token ，值为 登录时下发的JWT令牌。 如果检测到用户未登录，则直接响应 401 状态码 。

文件上传 ​

基本信息 ​

请求路径：/upload

请求方式：POST

接口描述：上传图片接口

请求参数 ​

参数格式：multipart/form-data

参数说明：

响应数据 ​

参数格式：application/json

参数说明：

响应数据样例：

JSON
{
    "code": 1,
    "msg": "success",
    "data": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-0400.jpg"
}