人才推荐系统API接口文档

说明：由于课程项目需要API文档，故写了此文档，仅用于学习。

1、用户详情

请求方法

rest/login

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 username string 是 admin password String 是 123456 role_id int 是 1 管理员1，hr 2,普通员工3

返回结果

JSON

{    code:200,    message:{"传递参数有误"}}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 message string 否 若请求出错，返回的错误内容

2、发布招聘信息

请求方法

rest/recruit/postRecruit

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 station_name string 是 实习岗 招聘名称 description string 是 岗位描述 requirement string 是 需求 spe_demand string 是 特殊需求 number int 是 招聘人数 deadline string 是 2016-02-05 截止时间’yyyy-MM-dd’ dep_id int 是 部门编号 place string 是 工作地点 job_id int 是 职能编号 is_fte int 是 是否全职0兼职，1全职 years string 是 工作年限 is_emergent int 是 是否紧急，1紧急，0不紧急

返回结果

{    code:200,    message:{"传递参数有误"}}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 message string 否 若请求出错，返回的错误内容

3、获取职能列表

请求方法

rest/job/jobList

支持格式

JSON

HTTP请求方式

get

返回结果

JSON

{    "jobList":[        {            "gmt_create":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "gmt_modified":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "id":1,            "job_name":"程序员"        },        {            "gmt_create":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "gmt_modified":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "id":1,            "job_name":"程序员"        }    },    "code":200}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 jobList json 是 若请求出错，返回的错误内容 gmt_create Date 是 创建日期 gmt_modified Date 是 修改日期 id int 是 job_name string 是 职能名称

4、获取部门列表

请求方法

rest/department/depList

支持格式

JSON

HTTP请求方式

get

返回结果

JSON

{    "depList":[        {            "gmt_create":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "gmt_modified":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "id":1,            "dep_name":"会计部",            "dep_phone":"",            "link_man":""        },        {            "gmt_create":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "gmt_modified":                {                    "date":18,                    "day":6,                    "minutes":14,                    "month":2,                    "nanos":0,                    "seconds":35,                    "time":1489806875000,                    "timezoneOffset":-480,                    "year":117                }            "id":1,            "dep_name":"会计部",            "dep_phone":"",            "link_man":""        }    },    "code":200}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 depList json 是 若请求出错，返回的错误内容 gmt_create Date 是 创建日期 gmt_modified Date 是 修改日期 id int 是 dep_name string 是 创建日期 dep_phone string 是 修改日期 link_man string 是 部门联系人

5、获取特定hr的招聘列表(带搜索和分页功能)

请求方法

rest/recruit/getOneHrRecruitList
说明：可以进行模糊查询

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 pageNo int 是 1 当前页数 keyword string 是 关键字，可以为null

返回结果

JSON

{    code:200,    RecruitBeanList:{        "totalCount":3,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "firstPage":true,        "prePage":1,        "lastPage":true,        "nextPage":1,        "list":[            {                "recruit_id":6,                "station_name":"fafsd",                "place":"324",                "u_id":6,                "username":"hr",                "dep_id":6,                "dep_name":"会计部",                "job_id":6,                "job_name":"程序员",                "number":3,                "status":0,                "deadline":1492012800000,                "recruit":null            },            {                "recruit_id":6,                "station_name":"fafsd",                "place":"324",                "u_id":6,                "username":"hr",                "dep_id":6,                "dep_name":"会计部",                "job_id":6,                "job_name":"程序员",                "number":3,                "status":0,                "deadline":1492012800000,                "recruit":null            }        ]    }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 RecruitBeanList json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 recruit_id int 是 station_name string 是 岗位名称 place string 是 工作地点 years string 是 工作年限 u_id int 是 username string 是 dep_id int 是 dep_name string 是 部门名称 job_id int 是 job_name string 是 职能名称 number int 是 招聘人数 status int 是 简历状态 deadline string 是 截止日期 recruit object 是 简历对象

6、获取所有的招聘列表(带搜索和分页功能)

请求方法

rest/recruit/ getRecruitList
说明：可以进行模糊查询

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 pageNo int 是 1 当前页数 keyword string 是 关键字，可以为null

返回结果

JSON

{    code:200,    RecruitBeanList:{        "totalCount":3,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "firstPage":true,        "prePage":1,        "lastPage":true,        "nextPage":1,        "list":[            {                "recruit_id":6,                "station_name":"fafsd",                "place":"324",                "u_id":6,                "username":"hr",                "dep_id":6,                "dep_name":"会计部",                "job_id":6,                "job_name":"程序员",                "number":3,                "status":0,                "deadline":1492012800000,                "recruit":null            },            {                "recruit_id":6,                "station_name":"fafsd",                "place":"324",                "u_id":6,                "username":"hr",                "dep_id":6,                "dep_name":"会计部",                "job_id":6,                "job_name":"程序员",                "number":3,                "status":0,                "deadline":1492012800000,                "recruit":null            }        ]    }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 RecruitBeanList json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 recruit_id int 是 station_name string 是 岗位名称 place string 是 工作地点 years string 是 工作年限 u_id int 是 username string 是 dep_id int 是 dep_name string 是 部门名称 job_id int 是 job_name string 是 职能名称 number int 是 招聘人数 status int 是 简历状态 deadline string 是 截止日期 recruit object 是 简历对象

7、获取单个招聘信息详情

请求方法

rest/recruit/recruitDetail

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 recruit_id int 是 1

返回结果

JSON

{    code:200,    recruitBean:{        "recruit_id":3,        "station_name":null,        "place":null,        "years":null,        "u_id":0,        "username":"hr",        "dep_id":0,        "dep_name":"会计部",        "job_id":0,        "job_name":"程序员",        "number":0,        "status":0,        "deadline":null,        "recruit":{            "id":6,            "station_name":"fafsd",            "u_id":2,            "number":3,            "dep_id":1,            "place":"324",            "job_id":1,             "is_fte":1,            "years":"234",            "deadline":1492012800000            "description":"<p>sdfaf</p>",            "requirement":"<p>dfs</p>",            "spe_demand":"sdf",            "is_emergent":0,            "status":0,            "gmt_create":1491634826000,            "gmt_modified":1491634826000        }    }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 recruitBean json 是 recruit_id int 是 创建日期 station_name string 是 岗位名称 place string 是 工作地点 years string 是 工作年限 u_id int 是 username string 是 dep_id int 是 dep_name string 是 部门名称 job_id int 是 job_name string 是 职能名称 number int 是 招聘人数 status int 是 简历状态 deadline string 是 截止日期 recruit object 是 简历列表 id int 是 station_name string 是 岗位名称 place string 是 工作地点 years string 是 工作年限 u_id int 是 description string 是 岗位描述 dep_id int 是 is_fte int 是 是否全职 job_id int 是 requirement string 是 需求 number int 是 招聘人数 status int 是 deadline string 是 截止时间 is_emergent int 是 是否紧急 spe_demand string 是 特殊需求 mt_create string 是 创建时间 gmt_modified string 是 最新修改时间

8、获取紧急招聘列表(附带搜索功能)

请求方法

rest/adminSelect/getRecruitlist

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 emergent int 是 1 是否紧急，1紧急，0不紧急 pageNo int 是 1 当前页数，以1开始 text string 是 可以为null，是搜索的关键字

返回结果

JSON

{    code:200,    recruits:{        "totalCount":3,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "firstPage":true,        "prePage":1,        "lastPage":true,        "nextPage":1,        "list":[            {                recruit_id":2,                "station_name":"程序员（实习岗",                "place":"杭州",                "years":"不限",                "u_id":2,                "username":"hr",                "dep_id":2,                "dep_name":"会计部",                "job_id":2,                "job_name":"程序员",                "number":2,                "status":0,                "deadline":1497801600000,                "recruit":null            },            {                recruit_id":2,                "station_name":"程序员（实习岗",                "place":"杭州",                "years":"不限",                "u_id":2,                "username":"hr",                "dep_id":2,                "dep_name":"会计部",                "job_id":2,                "job_name":"程序员",                "number":2,                "status":0,                "deadline":1497801600000,                "recruit":null            }        ]    }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 recruits json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 recruit_id int 是 station_name string 是 岗位名称 place string 是 工作地点 years string 是 工作年限 u_id int 是 username string 是 dep_id int 是 dep_name string 是 部门名称 job_id int 是 job_name string 是 职能名称 number int 是 招聘人数 status int 是 简历状态 deadline string 是 截止日期 recruit object 是 简历对象

9、获取简历列表（附带搜索功能）

请求方法

rest/resume/getResumeList
说明：可模糊查询

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 pageNo int 是 1 当前页数，以1开始 keyword string 是 1 可以为null，是搜索的关键字

返回结果

JSON

{    code:200,    resumeList:{        "totalCount":3,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "firstPage":true,        "prePage":1,        "lastPage":true,        "nextPage":1,        "list":[            {                "id":1,                "resume_name":"徐佳慧",                "u_id":3,                "position":"开发",                "gender":"女",                "degree":"大学",                "school":"浙江工商大学",                "is_study":0,                "gra_time":1488988800000,                "major":"软件",                "phone":"13216130161",                "email":"[e-mail]",                "skill":"ee",                "file_name":"xjh-testxjh.doc",                "status":0,                "gmt_create":1489916017000,                "gmt_modified":1491736382000,                "recruit":null            },            {                "id":1,                "resume_name":"徐佳慧",                "u_id":3,                "position":"开发",                "gender":"女",                "degree":"大学",                "school":"浙江工商大学",                "is_study":0,                "gra_time":1488988800000,                "major":"软件",                "phone":"13216130161",                "email":"[e-mail]",                "skill":"ee",                "file_name":"xjh-testxjh.doc",                "status":0,                "gmt_create":1489916017000,                "gmt_modified":1491736382000,                "recruit":null            }        ]    }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 resumeList json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 id int 是 resume_name string 是 简历名称 u_id string 是 简历提交的员工 position string 是 应聘岗位 gender int 是 性别 degree string 是 学历 school int 是 毕业学校 is_study int 是 是否在读,1在读，0不在读 gra_time long 是 毕业时间，毫秒 major string 是 专业 phone string 是 联系电话 email string 是 email skill string 是 技能 file_name object 是 上传的简历名字 gmt_create long 是 记录创建时间 毫秒 gmt_modified long 是 最新修改时间 毫秒

10、获取简历详情

请求方法

rest/resume/resumeDetail

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 resume_id int 是 1 当前页数，以1开始

返回结果

JSON

{    code:200,    resumeList:{        "id":1,        "resume_name":"徐佳慧",        "u_id":3,        "position":"开发",        "gender":"女",        "degree":"大学",        "school":"浙江工商大学",        "is_study":0,        "gra_time":1488988800000,        "major":"软件",        "phone":"13216130161",        "email":"[e-mail]",        "skill":"ee",        "file_name":"xjh-testxjh.doc",        "status":0,        "gmt_create":1489916017000,        "gmt_modified":1491736382000    }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 resumeList json 是 resume_name string 是 简历名称 u_id string 是 简历提交的员工 position string 是 应聘岗位 gender int 是 性别 degree string 是 学历 school int 是 毕业学校 is_study int 是 是否在读,1在读，0不在读 gra_time long 是 毕业时间，毫秒 major string 是 专业 phone string 是 联系电话 email string 是 email skill string 是 技能 file_name object 是 上传的简历名字 gmt_create long 是 记录创建时间 毫秒 gmt_modified long 是 最新修改时间 毫秒

11、修改简历

请求方法

rest/resume/updateResume

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 resume_id int 是 1 resume_name string 是 简历名称 position string 是 应聘岗位 gender int 是 性别 degree string 是 学历 school int 是 毕业学校 is_study int 是 是否在读,1在读，0不在读 gra_time long 是 毕业时间，毫秒 major string 是 专业 phone string 是 联系电话 email string 是 email skill string 是 技能

返回结果

JSON

{    "code":200,    "error":"..."}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 errror string 是 请求错误返回错误信息，否则为null

12、删除单条简历

请求方法

rest/resume/deleteResume

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 resume_id int 是 1

返回结果

{    "code":200,    "error":"..."}

返回字段说明

JSON

名称 类型 是否必须 说明 code int 是 http状态 errror string 是 请求错误返回错误信息，否则为null

13、删除多条简历

请求方法

rest/resume/deleteResume

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 resume_id int[] 是 1

返回结果

JSON

{    "code":200,    "error":"..."}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 errror string 是 请求错误返回错误信息，否则为null

14、添加简历

请求方法

rest/resume/addResume

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 rresume_id int 是 1 resume_name string 是 简历名称 position string 是 应聘岗位 gender int 是 性别 degree string 是 学历 school int 是 毕业学校 is_study int 是 是否在读,1在读，0不在读 gra_time long 是 毕业时间，毫秒 major string 是 专业 phone string 是 联系电话 email string 是 email skill string 是 技能

返回结果

JSON

{    "code":200,    "error":"..."}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 errror string 是 请求错误返回错误信息，否则为null

15、得到人才库列表（分页）

请求方法

rest/adminSelect/getTalentlist

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 pageNo int 是 1

返回结果

JSON

{    "talents":{        "totalCount":1,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "nextPage":1,        "prePage":1,        "firstPage":true,        "lastPage":true        "list":[            {                "id":1,                "position":"开发人员",                "gender":"女",                "degree":"本科",                "school":"浙江工商大学",                "is_study":1,                "gra_time":1501571671000,                "major":"软件工程",                "phone":"12132421",                "email":"[e-mail]",                "skill":"很厉害",                "file_name":"1323.txt",                "status":0,                "gmt_create":1493018066000,                "gmt_modified":1493018069000            },            {                "id":1,                "position":"开发人员",                "gender":"女",                "degree":"本科",                "school":"浙江工商大学",                "is_study":1,                "gra_time":1501571671000,                "major":"软件工程",                "phone":"12132421",                "email":"[e-mail]",                "skill":"很厉害",                "file_name":"1323.txt",                "status":0,                "gmt_create":1493018066000,                "gmt_modified":1493018069000            }        ]       }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 talents json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 id int 是 name string 是 姓名 position string 是 应聘岗位 gender int 是 性别 degree string 是 学历 school int 是 毕业学校 is_study int 是 是否在读,1在读，0不在读 gra_time long 是 毕业时间，毫秒 major string 是 专业 phone string 是 联系电话 email string 是 email skill string 是 技能 file_name object 是 上传的简历名字 status gmt_create long 记录创建时间 毫秒 gmt_modified long 最新修改时间 毫秒

16、得到员工列表（带搜索和分页功能）

请求方法

rest/adminSelect/getEmployeelist
说明：自带搜索功能

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 pageNo int 是 1 text string 是

返回结果

JSON

{    "users":{        "totalCount":1,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "nextPage":1,        "prePage":1,        "firstPage":true,        "lastPage":true        "list":[            {                "id":0,                "username":"xjh",                "real_name":"xujiahui",                "password":"人力资源部",                "salt":null,                "role_id":0,                "dep_id":0,                "email":null,                "score":0,                "status":0,                "gmt_create":null,                "gmt_modified":null            },            {                "id":0,                "username":"xjh",                "real_name":"xujiahui",                "password":"人力资源部",                "salt":null,                "role_id":0,                "dep_id":0,                "email":null,                "score":0,                "status":0,                "gmt_create":null,                "gmt_modified":null            }        ]       }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 users json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 id int 是 username string 是 用户名 real_name string 是 真实姓名 password string 是 32位 salt int 是 盐值 32位 role_id int 是 dep_id int 是 email string 是 score int 是 积分 status gmt_create long 记录创建时间 毫秒 gmt_modified long 最新修改时间 毫秒

17、得到hr列表（带搜索和分页功能）

请求方法

rest/adminSelect/getHrlist
说明：自带搜索功能

支持格式

JSON

HTTP请求方式

post

请求参数

名称 类型 是否必须 示例值 说明 pageNo int 是 1 text string 是

返回结果

JSON

{    "users":{        "totalCount":1,        "pageSize":10,        "pageNo":1,        "totalPage":1,        "firstResult":0,        "nextPage":1,        "prePage":1,        "firstPage":true,        "lastPage":true        "list":[            {                "id":0,                "username":"xjh",                "real_name":"xujiahui",                "password":"人力资源部",                "salt":null,                "role_id":0,                "dep_id":0,                "email":null,                "score":0,                "status":0,                "gmt_create":null,                "gmt_modified":null            },            {                "id":0,                "username":"xjh",                "real_name":"xujiahui",                "password":"人力资源部",                "salt":null,                "role_id":0,                "dep_id":0,                "email":null,                "score":0,                "status":0,                "gmt_create":null,                "gmt_modified":null            }        ]       }}

返回字段说明

名称 类型 是否必须 说明 code int 是 http状态 users json 是 totalCount int 是 总条数 pageSize int 是 每页显示数目 pageNo int 是 当前页 totalPage string 是 总页数 firstResult int 是 firstPage Boolean 是 prePage int 是 lastPage Boolean 是 nextPage int 是 下一页 list List< object > 是 简历信息列表 id int 是 username string 是 用户名 real_name string 是 真实姓名 password string 是 32位 salt int 是 盐值 32位 role_id int 是 dep_id int 是 email string 是 score int 是 积分 status gmt_create long 记录创建时间 毫秒 gmt_modified long 最新修改时间 毫秒