基本配置

基地址：

1.api认证统一使用token认证，数据返回统一使用json.
服务端开启cors,解决跨域问题。
2.请求方法

GET（SELECT）：从服务器取出资源（一项或多项）。
POST（CREATE）：在服务器新建一个资源。
PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
DELETE（DELETE）：从服务器删除资源。

接口返回数据失败，统一返回

 {
    "data": {
     
    },
    "meta": {
        "msg": "错误",
        "status": 0
    }
}
复制代码

接口明细

1.1登录接口

请求路径：login
请求方法：post
请求参数

参数名	参数说明	备注
username	用户名	不能为空，用户名为学号
password	用户密码	不能为空，默认为学号

响应数据

{
    "data": {
        "id":1,
        "username": "201719044120",
        "first_name": "张三",
        "roles": "student",//只能是student或者manager
        "token": "cdscij"
    },
    "meta": {
        "msg": "登录成功",
        "status": 200
    }
}

复制代码

1.2个人信息（学生个人信息，管理员端不需要）

1.2.1 上传个人信息

请求路径：user/complete_userInfo
请求方法：post
学生请求参数（姓名和班级、专业为管理员导入，学生不能修改）

参数名	参数说明	备注
username	用户名
age	年龄
email	邮箱
avatar	头像	url地址
phone_num	手机号
sex	性别	只能为男或者女
study_year	“2017-09-01,2021-06-01”	字符串类型，便于后端存储，返回前端时为数组类型
is_work	是否就业	0，1，2，3，4,-1找工作中，0实习，1就业，2考研成功，3继续学习，4其他
study_status	学习情况	学生对个人学习状态和情况的总结（非必填）

响应数据

{
    "data": {
        "username":"201719044120",
        "first_name": "张三",
        "created_time":"2020年3月28日"
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}


复制代码

1.2.2获取个人信息

请求路径：user/complete_userInfo
请求方法：get
请求参数

参数名	参数说明	备注
username	用户名

学生：响应数据

{
    "data": {
        "username":"201719044120",
        "first_name": "张三",
        "age": 22,
        "email":"2036241878@qq.com",
        "avatar":"http://123456",
        "phone_num":"1328371",
        "stu_class":"网络171",
        "sex":"男",
        "magor":"软件工程",
        "study_year":["2017-09-01","2021-06-01"],
        "is_work": 0,//-1找工作中，0实习，1就业，2考研成功，3继续学习，4其他
        "study_status":"正在学习前端",
        "created_time":"2020年3月28日"
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.2.3修改个人信息

请求路径：user/complete_userInfo
请求方法：put
学生请求参数

参数名	参数说明	备注
username	用户名
age	年龄
email	邮箱
avatar	头像	url地址
phone_num	手机号
sex	性别	只能为男或者女
study_year	在校时间	数组类型
is_work	是否就业	-1找工作中，0实习，1就业，2考研成功，3继续学习，4其他
study_status	学习情况	学生对个人学习状态和情况的总结（非必填）

响应数据

{
    "data": {
        "username":"201719044120",
        "first_name": "张三",
        "updated_time":"2020年3月28日",
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.3学生就业登记

1.3.1 学生上传就业信息

请求路径：user/employ_register
请求方法：post
请求参数

参数名	参数说明	备注
username	用户名
company_id	公司名
adress	“北京市/市辖区/东城区/”	字符串类型
code_adress	[“100010″,”120000″,”10000”]	数组类型，地址的代码
company_phone	公司电话	字符串类型
entry_time	入职时间	日期均为2020-3-28这种类型的字符串
pos_name	职位名称
is_train	是否培训	0没有，1培训
agreement_id	三方协议	url地址
salary	薪水	可以为空

响应数据

{
    "data": {
        "username":"201719044120",
        "first_name":"张志",
        "created_time":"2020-3-28"
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.3.2学生获取就业信息

请求路径：user/employ_register
请求方法：get
请求参数

参数名	参数说明	备注
username	用户名

响应数据（没有值相应数据则返回空，示例is_train:"" )

{
    "data": {
        "username":"201719044120",
        "company_id":"海康威视",
        "adress":"北京市/市辖区,/东城区/",//地址中文名
        "code_adress":["100010","120000","10000"],//地址代码
        "company_phone":"1232831",
         "entry_time":"2020-3-28",
         "pos_name":"web前端",
         "is_train":0,//是否参加过培训,0没有，1培训过
         "is_work":0,//当前的就业状态
         "agreement_id":"http://123456",
         "salary":13000,
         "first_name":"张志",
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.3.3学生修改就业登记信息

请求路径：user/employ_register
请求方法：put
请求参数

参数名	参数说明	备注
username	用户名
company_id	公司名
adress	“北京市/市辖区/东城区/”	字符串类型
code_adress	[“100010″,”120000″,”10000”]	数组类型，地址的代码
entry_time	入职时间
company_phone	公司电话	字符串类型
pos_name	职位名称
is_train	是否培训	0没有，1培训
agreement_id	三方协议	存储url地址
salary	薪水

响应数据

{
    "data": {
        "username":"201719044120",
        "first_name":"张志",
        "updated_time":"2020年3月28日"
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.3.4修改登陆密码

请求路径：user/modify_password
请求方法：post
请求参数

参数名	参数说明	备注
username	用户名
password	密码

响应数据

{
    "data": {
        "username":"201719044120",
        "updated_time":"2020年3月28日"
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.4管理员上传学生信息

1.4.1 通过excel导入学生信息

请求地址 manager/upload_user_info
请求方法 post
请求参数

参数名	参数说明	备注
userInfo	对象类型

userInfo:[
   {username:"201719044120",first_name:"张志",stu_class:"RB软工网",magor:"网络软件开发"}，
   {username:"201719044121",first_name:"张志",stu_class:"RB软工网",magor:"网络软件开发"}，
   {username:"201719044122",first_name:"张志",stu_class:"RB软工网",magor:"网络软件开发"}，
   {username:"201719044123",first_name:"张志",stu_class:"RB软工网",magor:"网络软件开发"}，
]

复制代码

响应数据

{
    "data": {
       
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.5信息中心

1.5.1管理员上传新闻

请求路径：manager/upload_news
请求方法：post,后端为每条新闻添加唯一的id
请求参数

参数名	参数说明	备注
news_title	新闻标题	不能为空
news_content	新闻内容	不能为空
news_picture	新闻图片	可以为空

响应数据

{
    "data": {
        news_id:10 ,//后端要给每一条新闻生成一个唯一的id 
        news_title:"好好学习",
        news_content:"天天向上",
        news_picture:""，
        created_time；""
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}


复制代码

1.5.2管理员修改新闻

请求路径：manager/upload_news
请求方法：put
请求参数

参数名	参数说明	备注
news_id	新闻编号
news_title	新闻标题	不能为空
news_content	新闻内容	不能为空
news_picture	新闻图片	可以为空

响应数据

{
    "data": {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        created_time：""
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}


复制代码

1.5.3删除新闻

请求路径：manager/upload_news
请求方法：delete
请求参数

参数名	参数说明	备注
news_id	新闻编号

响应数据

{
    "data": {
       
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.5.4获取所有新闻

请求路径：manager/upload_news
请求方法：get
请求参数
响应数据


{
    "data": {
        all_news:[ {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        created_time：""
    },
     {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        created_time：""
    },]
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}
复制代码

1.6学生获取新闻（学生多一个字段has_collect）

1.6.1学生点击收藏

请求路径：user/to_collect_news
请求方法：post
请求参数

参数名	参数说明	备注
news_id	新闻编号
username	用户名

响应数据


{
    "data": {
       "collect_num":9//已经收藏的新闻数量
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}
复制代码

1.6.2学生点击取消收藏

请求路径：user/to_collect_news
请求方法：put
请求参数

参数名	参数说明	备注
news_id	新闻编号
username	用户名

响应数据


{
    "data": {
       "collect_num":9//已经收藏的新闻数量
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}
复制代码

1.6.3学生获取所有新闻列表

请求路径：user/all_news
请求方法：get
请求参数

参数名	参数说明	备注
username	用户名

响应数据


{
    "data": {
        all_news:[ {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        has_collect: true,
        created_time：""
    },
     {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        has_collect: false,
        created_time：""
    },]
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}
复制代码

1.6.4学生获取收藏新闻列表

请求路径：user/collect_news
请求方法：get
请求参数

参数名	参数说明	备注
username	用户名

响应数据


{
    "data": {
        all_news:[ {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        has_collect: true,
        created_time：""
    },
     {
        news_id:10 //后端要给每一条新闻生成一个唯一的id 
        news_title:"",
        news_content:"",
        news_picture:"",
        has_collect: true,
        created_time：""
    },]
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}
复制代码

1.7管理员获取学生提交的就业信息

1.7.1管理员获取所有学生就业信息（包含审核过和未审核）

请求路径：manager/auitInfo
请求方法：get
请求参数（可以添加参数，获取所有参数为空）

参数名	参数说明	备注

响应数据

{
    "data": [{
        "auditInfo": 0, //审核状态0为未审核，1为审核通过
        "username":"201719044120",//用户名
        "company_id":"海康威视",//公司名称
        "adress":"北京市/市辖区,/东城区/",//公司地址
        "company_phone":"1232831",//公司手机号
         "entry_time":"2020年3月28日",//入职时间
         "pos_name":"web前端",//职位
         "is_train":0,//是否培训
         "status":0,//就业状态
         "agreement_id":"http://123456",//就业合同pdf，url地址
         "salary":13000,//薪资
         "first_name":"张志",
         "age": 22,
        "email":"2036241878@qq.com",
        "phone_num":"1328371",
        "stu_class":"网络171",
        "sex":"男",
        "magor":"软件工程",
        "is_work": 0,
        "study_status":"正在学习前端",
      
    },{...},{...}...
    
    ],
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.7.2管理员获取所有审核未通过的就业信息

请求路径：manager/auitInfo
请求方法：get
请求参数

参数名	参数说明	备注
auditInfo	0	审核未通过

响应数据

返回该班级下所有的审核未通过的就业信息，数据类型与返回所有相同

1.7.3管理员根据条件筛选条件获取就业信息

请求路径：manager/auitInfo
请求方法：post
请求参数

参数名	参数说明	备注
stu_class	参数为数组，支持多个班级查询	为空则不查
auditInfo	0或者1	为空则返回未审核和审核过的信息
username	姓名	支持模糊查询，输入张，可选出所有带张的就业信息，为空则不查

请求参数示例

stu_class： ["RB软工网171","RB软工网172"]

响应数据

返回该班级下所有的为审核就业的信息，数据类型与返回所有相同

1.7.4管理员提交审核通过的学生

请求路径：manager/upAuitInfo
请求方法：post
请求参数

参数名	参数说明	备注
auditUsers	所有通过审核的学生名单	由学号组成的数组

参数示例

 ["201719044120","201719044123"...]
复制代码

响应数据

{
    "data": {
       
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}

复制代码

1.8学生就业状态统计信息

1.8.1获取所有学生的就业状态数据，如已就业、实习中、考研成功…

请求路径：manager/workStatus
请求方法：get
请求参数
响应数据

{
    "data": {
       "emp_num": [
                {"value": 1048, "name": '找工作中'},//value代表人数，如找工作中的人数为1084
                {"value": 735, "name": '实习中'},
                {"value": 580, "name": '已就业'},
                {"value": 484, "name": '考研成功'},
                {"value": 300, "name": '继续学习'},
                {"value": 300, "name": '其他'}
            ],
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}


复制代码

1.8.2根据班级条件筛选获取就业状态

请求路径：manager/workStatus
请求方法：post
请求参数

参数名	参数说明	备注
stu_class	参数为数组，支持多个班级查询	为空或者不传则不查

参数示例

stu_class： ["RB软工网171","RB软工网172"]

响应数据

{
    "data": {
       "emp_num": [
                {"value": 1048, "name": '找工作中'},//value代表人数，如找工作中的人数为1084
                {"value": 735, "name": '实习中'},
                {"value": 580, "name": '已就业'},
                {"value": 484, "name": '考研成功'},
                {"value": 300, "name": '继续学习'},
                {"value": 300, "name": '其他'}
            ],
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}


复制代码

1.9培训和未培训的数据分析

请求路径：manager/is_train
请求方法：get
请求参数
响应数据

{
    "data": {
       "train_status": {
                 "平均薪资": {
                           "has_train":10000,//培训后的平均薪资
                           "no_train":5000,//未参加培训的平均薪资
                      }，
                  "人数": {
                           "has_train":100,//就业且参加过培训的人数
                           "no_train":600,//就业且未参加过培训的人数
                      }，
                   "前端开发": {
                           "has_train":100,//培训后从事前端的人
                           "no_train":600,//未培训从事前端的人
                      }，
                    "后端开发": {
                           "has_train":100,//
                           "no_train":600,//
                      }，
                     "UI设计师": {
                           "has_train":100,//
                           "no_train":600,//
                      }，
                     "产品经理": {
                           "has_train":100,//
                           "no_train":600,//
                      }，
                     "软件测试工程师": {
                           "has_train":100,//
                           "no_train":600,//
                      }，
                     "其他": {
                           "has_train":100,//
                           "no_train":600,//
                      }，
                     
            }
      
    },
    "meta": {
        "msg": "成功",
        "status": 200
    }
}


复制代码