EMP API文档
emp-api是为集微网EMP职场系统所工作的一套API服务。
新版文档支持：
- 中文搜索
- 语言高亮代码块
- Markdown文件同步
接口调用的参数格式
目前接口部分使用 HTTP 的 B**o**dy 来进行参数传递，接口支持 application/json 的 Body 格式
同时也支持 application/x-www-form-urlencoded 的 Body 格式 ，使用前需要在 Header 中注明 内容类型字段。
请勿使用from-data
鉴权
API 系统的鉴权分为两步:
1.第一步获取鉴权Token
大部分api 所使用的鉴权 Token 来自获取接口鉴权 的access/token 接口 返回
2.第二步获取的Token 去调用其他的接口
接口使用的是基于 rfc6750 的Bearer Token 鉴权
我们的Bearer Token 使用的是 JWT，在实际业务中并不需要每次调用接口前都去获取Token，在Token的有效期内可以直接用现有的Token进行接口调用，目前我们的Token 有效期为1小时。
！！！注意：需要随时监测返回响应的 Header 中的 Authorization 属性， 若响应返回新的 token 需要清除旧的Toekn 来做到刷新token。
接口返回
第一层 http code返回码，目前常见返回码如下
| Http code | 说明 |
|---|---|
| 200 | 调用成功 |
| 400 | 调用失败，返回自定义错误 |
| 401 | 鉴权失败 |
| 403 | 权限不足，没有调用权限 |
| 500 | 服务器本身出错 |
第二层 接口返回内容中的status和error字段
对于status,我们有如下规定
- status 是一个自然数
- status = 0表示接口调用成功
- status ∈ [100,200) 表示接口调用失败，这一部分的错误号是全接口通用的，在不同接口中表示同样的错误
- status >= 200 表示接口调用失败，这一部分错误号是每个接口独立的，同一个错误码在不用接口中会表示不一样的错误,具体错误说明在接口中会说明
| status | 说明 |
|---|---|
| 100 | 请求体错误,如请求体格式不对此错误一般伴随http 400 返回码 |
| 101 | 请求体错误,如缺少必要的请求参数、参数不合法,此错误一般伴随http 400 返回码 |
| 110 | 所请求的接口对于所携带的token其所属用户来说权限不足,此错误一般伴随http 403 返回码 |
| 111 | 所请求的接口使用了权限控制，但未在系统中登记权限路由名称,此错误一般伴随http 403 返回码 |
| 112 | 所请求的接口使用了权限控制，但未在系统中登记权限路由所属角色关联,此错误一般伴随http 403 返回码 |
error
为一个字符串字段，会给出status的具体错误原因描述，这个字段适用于程序开发中的错误调试，不应该把他的返回内容作为代码逻辑判断的条件。也不应直接在前端页面显示。
分页
可以分页的接口在第二次中同时会返回分页所需的字段。
| status | 说明 |
|---|---|
current_page |
当前页面页码 |
last_page |
最后一页页码 |
total |
该资源的全部数量 |
接口地址说明
| http | https | |
|---|---|---|
| 线下 | 47.112.148.159:8781 | |
| 预发布 | http://emppreview.laoyaoba.com/ | |
| 正式 | http://emp.laoyaoba.com/ |
所有的接口统一路由前缀为 /api 如 “47.112.148.159:8781/api/access/token” 。
首页内容相关接口
提交意见反馈接口 feedback
这个接口根据头部信息中的JWT令牌，会返回账号的基础信息。
接口地址
/feedback/add
请求方式
POST
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| source | string | 请求来源，pc、h5、ios、xcx、android | 是 |
| content | string | 反馈内容（最多500字符） | 是 |
| token | string | 用户信息 | 是 |
请求示例
{
"source": "pc",
"content": "反馈内容"
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | UserInfo Object |
返回示例
{
"status": 0,
"data": {
成功不返回值，失败返回错误信息
}
}
Status返回值
| Api code | 说明 |
|---|---|
| 201 | 获取资源安全断言错误 |
| 202 | 保存数据失败 |
获取首页数据报表基础信息 report
这个接口根据头部信息中的JWT令牌，会返回账号的基础信息。
接口地址
/report/index
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| token | string | 用户信息 | 是 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | UserInfo Object |
PAYLOAD
| 参数 | 类型 | 说明 |
|---|---|---|
position_total_num |
int | 统计该登录客户截止 昨天24点所有在招、暂停的职位总数 |
position_recruit_num |
int | 统计该登录客 户截止昨天24点所有在招的职位总数 |
cv_receive_num |
int | 统计该登录客户 截止昨天24点所有收到的简历总数 |
cv_add_num |
int | 统计该 登录客户昨日新增收到简历数 |
返回示例
{
"status": 0,
"data": {
"position_total_num": "职位总数",
"position_recruit_num": "在招职位数",
"cv_receive_num": "已收简历数",
"cv_add_num": "昨日新增简历数",
}
}
Status返回值
| Api code | 说明 |
|---|---|
| 201 | 获取资源安全断言错误 |
| 202 | |
个人中心模块接口 personal
修改个人信息
接口地址
/personal/account
请求方式
PUT
请求参数
BODY
| 参数 | 类型 | 说明 |
|---|---|---|
| nickname | string | 展示名称 |
| password | string | 密码 |
| tele | string | 联系人电话 |
| intro | string | 个人简介 |
| avatar | string | 头像 |
请求示例
{
"intro": "EMP测试HR专用公司简介",
"nickname": "EMP测试HR专用公司!",
"tele": 13341237888,
"password": "asdqwe1234"
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 成员（Member:Object）列表 |
Member:Object成员
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| account | string | 账号 |
| member_type | string | 成员类型 |
| nickname | string | 展示名称 |
| tele | string | 联系人电话 |
| intro | string | 个人简介 |
返回示例
{
"status": 0,
"data": {
"account": "ceshihr",
"member_type": "hr",
"nickname": "EMP测试HR专用公司!",
"tele": "13341237888",
"intro": "EMP测试HR专用公司简介",
"avatar": ...
}
}
Status返回值
| status | 说明 |
|---|
修改当前用户所在公司信息
接口地址
/personal/company
请求方式
PUT
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| company_name | string | 职位名称 |
| company_short | string | 公司简称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| address | string | 公司地址 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
| treatments | array | Treament:object 福利待遇 [1,2,3,4] |
请求示例
{
"company_name": "EMP测试HR专用公司！",
"company_short": "EMP测试HR专用公司！",
"logo": "jwImg/4acdda32e555a141.jpg",
"intro": "用来给EMP测试！",
"capitalization": "B轮",
"scale": 3,
"address": "海淀区",
"treatments":[1,16]
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 公司（Company:Object）列表 |
Company:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| company_name | string | 职位名称 |
| show_name | string | 公司名称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| address | string | 公司地址 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
| treatments | array | Treament:object 福利待遇 |
Treatment:object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 职位名称 |
返回示例
{
"status": 0,
"data": {
"id": 40,
"company_name": "EMP测试HR专用公司！",
"company_short": "EMP测试HR专用公司！",
"address": "海淀区",
"logo": "http://s.laoyaoba.com/jwImg/4acdda32e555a141.jpg",
"intro": "用来给EMP测试！",
"capitalization": "B轮",
"scale": 3,
"treatments": [
{
"id": 1,
"treatment_name": "包吃"
},
{
"id": 16,
"treatment_name": "十一险一金1111"
}
]
}
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 福利待遇不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/07/02 | 张宏伟 | 新增公司简称字段 |
查看当前用户所在公司信息
接口地址
/personal/company
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 公司（Company:Object）列表 |
Company:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| company_name | string | 职位名称 |
| company_short | string | 公司简称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| address | string | 公司地址 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
| treatments | array | Treament:object 福利待遇 |
| customer_service | object | 公司对接客服信息 |
customer_service
| 参数 | 类型 | 说明 |
|---|---|---|
| customer_service_name | string | 客服姓名 |
| customer_service_tele | string | 客服电话 |
| customer_service_email | string | 客服邮箱 |
Treatment:object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 福利待遇名称 |
返回示例
{
"status": 0,
"data": {
"id": 40,
"company_name": "EMP测试HR专用公司！",
"company_short": "EMP测试HR专用公司！",
"logo": "http://s.laoyaoba.com/jwImg/4acdda32e555a141.jpg",
"intro": "用来给EMP测试！",
"capitalization": "B轮",
"scale": 3,
"address": "海淀区",
"treatments": [
{
"id": 1,
"treatment_name": "包吃"
},
{
"id": 16,
"treatment_name": "十一险一金1111"
}
],
"customer_service": {
"customer_service_name": "客服",
"customer_service_tele": "13322211111",
"customer_service_email": "y8yy@118.com"
}
}
}
Status返回值
| status | 说明 |
|---|
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/07/02 | 张宏伟 | 新增公司简称字段 |
客户的角色管理 member:role
修改账号权限的角色
接口地址
/member/role/{id}
请求方式
PUT
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| role_name | string | 角色名称 |
| active_status | bool | 状态 |
| 待定 | object | 菜单权限控制对象 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 角色（Role:Object） |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| role_name | string | 角色名称 |
| active_status | bool | 状态 |
| 待定 | object | 菜单权限控制对象 |
| created_time | int | 创建时间 |
返回示例
{
"status": 0,
"data": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 不可以关闭已经开启的角色 |
| 202 | 角色名重复 |
删除账号权限的角色
接口地址
/member/role/{id}
请求方式
DELETE
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
返回示例
{
"status": 0
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 不可以删除已经开启的角色 |
新增账号权限的角色
接口地址
/member/role
请求方式
POST
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| role_name | string | 角色名称 |
| active_status | bool | 状态 |
| 待定 | object | 菜单权限控制对象 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 角色（Role:Object） |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| role_name | string | 角色名称 |
| active_status | bool | 状态 |
| 待定 | object | 菜单权限控制对象 |
| created_time | int | 创建时间 |
返回示例
{
"status": 0,
"list": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 202 | 角色名称重复 |
查看账号的角色权限
接口地址
/member/role/id
请求方式
GET
请求参数
**请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 角色（Role:Object） |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| role_name | string | 角色名称 |
| active_status | bool | 状态 |
| role_detail | array | 菜单权限 |
| created_time | int | 创建时间 |
role_detail详细参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 当前权限菜单id |
| title | string | 权限菜单名称 |
| parent_id | int | 权限菜单父级id 0为定级 |
| view_code | int | 当前菜单查看权限 0无权限 1所有人 2本人 |
| handle_code | int | 当前菜单操作权限 0无权限 1所有人 2本人 |
| view_power | array | 当前菜单查看权限选项 |
| code | int | 权限代号 |
| power | string | 代号名 |
| isActive | bool | 选中状态 |
| handle_power | array | 当前菜单操作权限选项 （组内字段含义同查看权限） |
| menu | array | 当前菜单所包含的子菜单 |
| isActive | bool | 选中状态 |
返回示例
{
"status": 0,
"data": {
"id": 203,
"role_name": "二测",
"role_label": "二测",
"active_status": false,
"role_detail": [
{
"id": 1,
"title": "我的资料",
"parent_id": 0,
"view_code": 1,
"handle_code": 0,
"rel_id": 12,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": false
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 2,
"title": "个人中心",
"parent_id": 1,
"view_code": 1,
"handle_code": 0,
"rel_id": 13,
"isActive": true
}
]
},
{
"id": 3,
"title": "数据中心",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 14,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 4,
"title": "基础服务",
"parent_id": 3,
"view_code": 1,
"handle_code": 1,
"rel_id": 15,
"isActive": true
}
]
},
{
"id": 5,
"title": "职位管理",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 16,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 6,
"title": "职位列表",
"parent_id": 5,
"view_code": 1,
"handle_code": 1,
"rel_id": 17,
"isActive": true
}
]
},
{
"id": 7,
"title": "简历管理",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 18,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 8,
"title": "简历列表",
"parent_id": 7,
"view_code": 1,
"handle_code": 1,
"rel_id": 19,
"isActive": true
}
]
},
{
"id": 9,
"title": "权限与账号",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 20,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 10,
"title": "角色权限",
"parent_id": 9,
"view_code": 1,
"handle_code": 1,
"rel_id": 21,
"isActive": true
},
{
"id": 11,
"title": "账号管理",
"parent_id": 9,
"view_code": 1,
"handle_code": 1,
"rel_id": 22,
"isActive": true
}
]
}
],
"created_time": 1644227427
}
}
Status返回值
| status | 说明 |
|---|---|
| 202 | 角色名称重复 |
获取账号权限的角色列表
接口地址
/member/role
请求方式
GET
请求参数
QUERY STRING
| 参数 | 类型 | 说明 |
|---|---|---|
| search | string | 职位名称 |
| status | string | on&off |
请求示例
支持name模糊查询
*/member/role?search=管理员*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 角色（Role:Object）列表 |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| role_name | string | 角色名称 |
| role_label | string | 展示名称 |
| active_status | bool | 状态 |
| created_time | int | 创建时间 |
返回示例
{
"status": 0,
"data": [
{
"id": 203,
"role_name": "二测",
"role_label": "二测",
"active_status": false,
"created_time": 1644227427
},
{
"id": 195,
"role_name": "测试角色",
"role_label": "测试角色",
"active_status": true,
"created_time": 1643020733
},
{
"id": 194,
"role_name": "普通角色",
"role_label": "普通角色",
"active_status": true,
"created_time": 1643020586
},
{
"id": 193,
"role_name": "ROOT",
"role_label": "企业管理员",
"active_status": true,
"created_time": 1643020335
}
]
}
Status返回值
| status | 说明 |
|---|---|
| 202 | status参数有误 |
客户的用户管理 member
修改用户
接口地址
/member/{id}
请求方式
PUT
请求参数
BODY
| 参数 | 类型 | 说明 |
|---|---|---|
| nickname | string | 展示名称 |
| password | string | 密码 |
| role_id | int | Role_ID |
| tele | string | 联系人电话 |
| active_status | bool | 状态 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 成员（Member:Object）列表 |
Member:Object成员
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| account | string | 账号 |
| nickname | string | 展示名称 |
| role | object | Role:Object |
| active_status | bool | 状态 |
| tele | string | 联系人电话 |
| created_time | int | 创建时间 |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 角色名称 |
返回示例
{
"status": 0,
"data": {
}
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 角色不存在 |
| 202 | 已经启用不可以禁用 |
删除用户
接口地址
/member/{id}
请求方式
DELETE
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
返回示例
{
"status": 0
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 启用状态不可以删除 |
新增用户
接口地址
/member
请求方式
POST
请求参数
BODY
| 参数 | 类型 | 说明 |
|---|---|---|
| account | string | 账号 |
| nickname | string | 展示名称 |
| password | string | 密码 |
| role_id | int | Role_ID |
| tele | string | 联系人电话 |
| active_status | bool | 状态 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 成员（Member:Object）列表 |
Member:Object成员
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| account | string | 账号 |
| nickname | string | 展示名称 |
| role | object | Role:Object |
| tele | string | 联系人电话 |
| active_status | bool | 状态 |
| created_time | int | 创建时间 |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 角色名称 |
返回示例
{
"status": 0,
"data": {
}
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 角色不存在 |
获取账号权限的用户列表
接口地址
/member
请求方式
GET
请求参数
QUERY STRING
| 参数 | 类型 | 说明 |
|---|---|---|
| search | string | 账号搜索 |
| unique | string | 账号搜索(唯一) 与其他的参数互斥！ |
| status | string | on&off |
请求示例
支持name模糊查询
*/member?search=addcim*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 成员（Member:Object）列表 |
Member:Object成员
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| account | string | 账号 |
| nickname | string | 展示名称 |
| role | object | Role:Object |
| active_status | bool | 状态 |
| tele | string | 联系人电话 |
| created_time | int | 创建时间 |
Role:Object角色
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 角色名称 |
返回示例
{
"status": 0,
"data": [
{
"id": 264,
"account": "ceshi0207",
"nickname": "爱集微",
"email": "1243879519@qq.com",
"role": {
"id": 195,
"name": "测试角色",
"label": "测试角色"
},
"tele": "17695666730",
"created_time": 1644213211,
"active_status": true
},
{
"id": 263,
"account": "ceshi0126",
"nickname": "张",
"email": "1243879519@qq.com",
"role": {
"id": 193,
"name": "ROOT",
"label": "企业管理员"
},
"tele": "15133971604",
"created_time": 1643020335,
"active_status": true
}
]
}
Status返回值
| status | 说明 |
|---|---|
| 202 | status参数有误 |
简历相关接口 cv
下载的简历列表、搜索接口
使用这个接口 获取所有简历列表
排序按照创建时间由近及远进行
接口地址
/cv/download
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明（如果一起传多个则会都满足的情况才会返回结果，如果不想搜索某条件，则不传该参数） | 必填 |
|---|---|---|---|
| page | int | 第几页 | 否 |
| limit | int | 每页条数 | 否 |
| name | string | 模糊搜索姓名name='eric' | 否 |
请求示例
// body 传参示例
{
"page":2, // 第二页
"limit":20, // 每页20条
"name":"姓名"
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | object | 数据列表 |
返回示例
{
"status": 0,
"list": [
{
"id": 简历表主键id,
"name": "姓名",
"avatar": "头像",
"user_info": "男|3年|本科|20万/年",
"project_info": "2017年8月30日-2020年4月26日|华为技术有限公司|PHP开发工程师",
"updated_at": 修改时间,
"created_at": 创建时间戳,
}
],
"current_page": 当前页码,
"last_page": 总页数,
"per_page": 一页多少条,
"total": 总条数
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 199 | 未加载安全断言中间件 |
| 201 | limit不是正整数 |
下载附件简历
接口地址
/cv/download*/{id}*
请求方式
GET
请求参数
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| id | int | 简历主键id | 是 |
请求示例
// 下载简历表主键id为1的简历附件
/cv/download/1
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据信息 |
返回示例
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | <span style="color: rgb(106,135,89);">权限不够</span> |
| 202 | <span style="color: rgb(106,135,89);">未找到简历附件</span> |
| 203 | <span style="color: rgb(106,135,89);">获取附件简历失败</span> |
| 204 | <span style="color: rgb(106,135,89);">下载记录插入失败</span> |
导出在线简历
接口地址
/cv/word/{id}
请求方式
GET
请求参数
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| id | int | 简历主键id | 是 |
请求示例
// 导出在线简历
/cv/word/1
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据信息 |
返回示例
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 权限不够 |
| 202 | 未找到简历相关信息 |
| 203 | 插入下载记录失败 |
投递的简历列表、搜索接口
使用这个接口 获取所有简历列表
排序按照创建时间由近及远进行
接口地址
/cv/deliver
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明（如果一起传多个则会都满足的情况才会返回结果，如果不想搜索某条件，则不传该参数） | 必填 |
|---|---|---|---|
| page | int | 第几页 | 否 |
| limit | int | 每页条数 | 否 |
| position_id | int | 职位下投递的简历列表 position_id=1 | 否 |
| position_name | String | 模糊搜索 职位名称 position_name=开发 | 否 |
| name | string | 模糊搜索姓名name='eric' | 否 |
| phone | string | 模糊搜索手机号码 | 否 |
| is_double | int | 是否是双选会 0为否1为是 | 否 |
| start_ctime | int | 投递简历时间 开始查询 10为时间戳 | 否 |
| end_ctime | int | 投递简历时间 结束查询 10为时间戳 | 否 |
| edu_list | int | 学历 | 否 |
| years | int | 工作年限 | 否 |
| map_code | int | 职位地点 | 否 |
| status | int | 当前状态（1、未查看2、已查看3、已发出面试邀约4、不合适） | 否 |
| type | int | 类型 1-3 1 校招、2 实习、3 社招 | 否 |
| salary | int | 薪资范围 1 为3K以下 2为3-5K 3为5-10K 4为10-20K 5为20-50K 6为50K以上 | 否 |
请求示例
// body 传参示例
{
"page":2, // 第二页
"limit":20, // 每页20条
"position_id": 1, // 职位id
"position_name": "", // 职位名称
"name":"姓名",
"phone":13333891144, //手机号
"start_ctime":1352412305, //投递简历时间 开始查询
"end_ctime":1352412305, //投递简历时间 结束查询
"edu_list":3, //学历列表
"years":8, //工作年限
"map_code":23, //手机号
"status":1, //当前状态（1、未查看2、已查看3、已发出面试邀约4、不合适 不传为全部）
"type":1 //类型
"salary": 1 //薪资范围
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | object | 数据列表 |
返回示例
{
"status": 0,
"list": [
{
"id": "简历表主键id",
"cv_lov_id": "简历投递id",
"name": "姓名",
"phone": "13333891144", //手机号
"avatar": "头像",
"user_info": "男|3年|本科|20万/年",
"wish_salary_section": "3K-5K",
"educ": {
"id": 93,
"school": "测试",
"major": "测试",
"educ_name": "本科",
"start_time": 1633017600,
"end_time": 1638288000
},
"process_status": "已发出面试邀请",
"job_name": "在职，暂时不想跳槽",
"project_info": "2017年8月30日-2020年4月26日|华为技术有限公司|PHP开发工程师",
"project": {
"id": 133,
"start_time": "2020.11.01",
"end_time": "至今",
"company": "爱集微",
"position_name": "测试",
"project": "哈哈我职位描述：\n\n岗位职责：1.参与云产品的前端功能的设计与研发，及持续重构；2.承担产品的前端主要开发和用户体验优化工作；3.负责上线系统的日常维护工作，及时跟进问题反馈，快速定位并予以修复；4.了解公司现有业务和产品，进行产品的完善，形成知识库。任职要求：1、应届毕业生，计算机或相关专业；2、掌握一门主流开发语言，了解数据库，能够编写简单的SQL语句；3、具有良好的沟通表达能力；4、具有极强的责任心及工作积极性、主动性。觉得"
},
"position_name":"职位名称",
"position_id": 1,
"created_at": "创建时间戳",
"delivery_time": "2022.07.25 14:11"
"type": "校招"
}
],
"current_page": "当前页码",
"last_page": "总页数",
"per_page": "一页多少条",
"total": "总条数"
}
data Object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | id |
| cv_log_id | int | 简历投递记录id |
| name | string | 名称 |
| phone | string | 手机号 |
| avatar | string | 头像 |
| user_info | string | 个人信息概述 |
| educ | educ Obejct |
个人学历信息 |
| process_status | string | 当前投递简历状态 |
| wish_salary_section | string | 薪资区间 |
| job_name | string | 当前求职状态 |
| project_info | string | 工作经验概述 |
| project | project Object |
工作经验详情 |
| position_name | string | 应聘职位名称 |
| position_id | string | 应聘职位id |
| updated_at | int | 修改时间 |
| created_at | int | 创建时间 |
| type | string | 类型 |
| delivery_time | string | 投递简历时间 |
| active_name | string | 活跃情况 |
educ
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 学历id |
| school | string | 学校名称 |
| major | string | 专业名称 |
| educ_name | string | 学历 |
| start_time | int | 开始就读时间 |
| end_time | int | 结束就读时间 |
project Object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 工作经验id |
| start_time | string | 工作经验开始时间 |
| end_time | string | 工作经验结束时间 |
| company | string | 工作公司 |
| position_name | string | 工作职务 |
| project | string | 项目描述 |
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | |
| 202 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/06/30 | 张宏伟 | 新增case字段 |
查看简历完整信息事件接口
接口地址
/cv/auth*/{id}*
请求方式
GET
请求参数
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| id | int | 简历主键id | 是 |
请求示例
// 下载简历表主键id为1的简历附件
/api/cv/auth/1
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据信息 |
返回示例
{
"status":0,
"data":{
"id": 简历主键id,
"name": "姓名",
"tel": "电话",
"email": "邮箱"
},
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 未找到简历信息 |
| 202 | <span style="color: rgb(106,135,89);">下载记录插入失败</span> |
| 203 | 处理相关业务失败 |
| 204 | 请购买相关服务 |
查看单个简历详细信息接口
接口地址
/cv/{id}
请求方式
GET
请求参数
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| id | int | 简历主键id | 是 |
请求示例
// 简历详情
/cv/1
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据信息 |
data
| 参数 | 类型 | 说明 | 版本 |
|---|---|---|---|
| id | int | 简历主键ID | 2022 10月份 迭代 |
| name | string | 名称 | 2022 10月份 迭代 |
| sex | int | 性别（1男，2女） | 2022 10月份 迭代 |
| age | int | 年龄 | 2022 10月份 迭代 |
| tel | string | 电话联系方式 | 2022 10月份 迭代 |
| string | 邮箱 | 2022 10月份 迭代 | |
| avatar | string | 头像 | 2022 10月份 迭代 |
| intro | string | 个人优势 | 2022 10月份 迭代 |
| job_status | int | 求职状态（默认1离职找工作，2在职暂不考虑，3在职考虑机会） | 2022 10月份 迭代 |
| status | int | 状态（默认1全部不可见，2全部可见，3HR可见，4猎头可见） | 2022 10月份 迭代 |
| download_num | int | 下载数 | 2022 10月份 迭代 |
| province | string | 省 | 2022 10月份 迭代 |
| city | string | 市 | 2022 10月份 迭代 |
| county | string | 区 | 2022 10月份 迭代 |
| years_name | string | 工作年限 | 2022 10月份 迭代 |
| salary | string | 目前薪资 | 2022 10月份 迭代 |
| remark | string | 其他信息 | 2022 10月份 迭代 |
| updated_at | int | 更新时间 | 2022 10月份 迭代 |
| wish_list | array | 求职意向 | 2022 10月份 迭代 |
| project_list | array | 工作经历 | 2022 10月份 迭代 |
| educ_list | array | 教育经历 | 2022 10月份 迭代 |
| interest | string | 兴趣特长 | 2022 10月份 迭代 |
| opus | array | 作品展示 | 2022 10月份 迭代 |
| skills | array | 专业技能 | 2022 10月份 迭代 |
project_experiences_list
| 参数 | 类型 | 说明 | 版本 |
|---|---|---|---|
| id | int | ID |
2022 10月份 迭代 |
| start_time | int | 开始时间 | 2022 10月份 迭代 |
| end_time | int | 开始时间 | 2022 10月份 迭代 |
| role | string | 角色 | 2022 10月份 迭代 |
| extra | string | 项目描述 | 2022 10月份 迭代 |
| name | string | 项目名称 | 2022 10月份 迭代 |
| link | string | 项目链接 | 2022 10月份 迭代 |
certificate
| 参数 | 类型 | 说明 | 版本 |
|---|---|---|---|
| id | int | ID |
2022 10月份 迭代 |
| name | string | 证书名称 | 2022 10月份 迭代 |
| attachment_content | string | 证书附件 | 2022 10月份 迭代 |
opus
| 参数 | 类型 | 说明 | 版本 |
|---|---|---|---|
| id | int | 作品ID |
2022 10月份 迭代 |
| name | string | 作品名称 | 2022 10月份 迭代 |
| link | string | 作品连接 | 2022 10月份 迭代 |
| intro | string | 作品描述 | 2022 10月份 迭代 |
| attach | array | 附件 | 2022 10月份 迭代 |
skill
| 参数 | 类型 | 说明 | 版本 |
|---|---|---|---|
| id | int | 专业技能Id | 2022 10月份 迭代 |
| name | string | 专业技能名称 | 2022 10月份 迭代 |
| mastery | string | 熟练度 | 2022 10月份 迭代 |
返回示例
{
"status":0,
"data":{
"id": 简历表主键id,
"permission": "true/false 是否有权限",
"name": "姓名",
"sex_name": 性别,
"age": 年龄,
"tel": "手机号",
"email": "邮箱",
"educ_name": "学历",
"avatar": "头像",
"intro": "自我评价",
"job_name": 求职状态,
"province": "省",
"city": "市",
"years": 工作年限,
"salary_name": 目前薪资（单位：万/年）,
"remark": "其他信息",
"position_name": 目前职位名称,
"wish_list": [ // 求职意向列表
{
"id": 求职意向表主键id,
"wish_province": "期望省",
"wish_city": "期望市工作地点",
"wish_salary": 期望薪资（单位：万/年）,
"wish_position_name": "期望职位名称",
"position_list": [ // 期望职能列表
{
"id": 职能标签主键id,
"name": "职能标签名",
"field_info": { // 父极职能分类相关信息
"id": 父极职能分类主键id,
"name": "职能分类名称",
}
}
]
}
],
"project_list": [ // 工作经验列表
{
"id": 工作经验表主键id,
"start_time": 开始时间,
"end_time": 结束时间，如果为1则是至今,
"company": "公司名",
"position_name": 职位名称,
"project": "工作经验",
}
],
"educ_list": [ // 受教育经历
{
"id": 教育经历表主键id,
"start_time": 开始时间戳,
"end_time": 结束时间戳,
"educ_name": 学历,
"school": "学校名称",
"major": "专业",
"full_name": 是否全日制,
}
],
"project_experiences_list": [
{
"id": 项目经验ID,
"start_time": 项目开始时间,
"end_time": 项目结束时间,
"role": 担任角色,
"extra": 项目描述,
"name": 项目名称,
"link": 项目链接地址,
}
],
"opus": [
{
"id": 2,
"name": "作品名称",
"link": "作品展示连接",
"intro": "作品展示介绍",
"attach": ["附件图片地址"]
}
],
"skill": [
{
"id": 4,
"name": "技能名称",
"mastery": "熟练"
}
],
"interest": 兴趣特长,
"certificate": [
{
"id": 3,
"name": "证书名称",
"attachment_content": ["附件地址"]
}
]
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 参数有误 |
| 202 | 数据库错误 |
简历列表
使用这个接口 获取所有简历列表
排序按照更新时间倒序，若时间相同，则按照姓名首字母顺序排序
接口地址
/cv/list
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明（如果一起传多个则会都满足的情况才会返回结果，如果不想搜索某条件，则不传该参数） | 必填 |
|---|---|---|---|
| page | int | 第几页 | 否 |
| limit | int | 每页条数 | 否 |
| 以下是搜索简历主表： | |||
| job_status | int | 1离职找工作，2在职暂不考虑，3在职考虑机会（job_status=1） | 否 |
| educ_list | int | 搜索学历（1大专，2本科，3硕士，4博士，5MBA）educ_list = 1 | 否 |
| years | array | 搜索工作年限，1为应届生，2为1~3年，3为3~5年，4为5~10年，5为10年以上，支持多选，json数组形式[1,2] | 否 |
| wish_salary | array | [1,30]，第一个元素为期望薪资最小值，第二个为期望薪资最大值。 | |
| 以下是搜索求职意向相关表： | |||
| wish_map_code | string | 搜索期望省市（传的省市的code，比如北京市传wish_map_code=1100，南京市传3201） | 否 |
| 搜索工作经验表： | |||
| project_word | string | 模糊搜索关键词 | 否 |
| 搜索期望职能表： | |||
| wish_positions | array | 搜索期望职能，json数组形式[[2,0],[1,1],[3,0]]，支持多选最多选中标签5个， 二维数组中第一个值是分类id（注意：第一个值不能为0，否则抛出异常），第二个值是职能id | 否 |
| 排序方式： | |||
| sort_type | int | 1、按期望薪资由低到高，2、按学历由低到高，3、按工作年限由高到低 | 否 |
请求示例
// body 传参示例
{
"page":2, // 第二页
"limit":20, // 每页20条
"salary_sort":"asc", //
"educ_sort":"desc",
"years_sort":"asc",
"job_status":1,
"wish_name":"php",
"educ_list":[1,2],
"years":[2],
"wish_positions":[[1,2]], // 分类不限时传空数组[]或者不传该字段
"wish_map_code":"1100" // 搜索期望省市
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | object | 数据列表 |
返回示例
{
"status": 0,
"list": [
{
"id": 简历表主键id,
"name": "姓名",
"avatar": "头像",
"user_info": "男|3年|本科|20万/年",
"project_info": "2017年8月30日-2020年4月26日|华为技术有限公司|PHP开发工程师",
"updated_at": 修改时间,
"created_at": 创建时间戳,
}
],
"current_page": 当前页码,
"last_page": 总页数,
"per_page": 一页多少条,
"total": 总条数
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | |
| 202 |
收藏简历列表
使用这个接口 获取当前管理账号收藏简历列表
排序按照更新时间倒序
接口地址
/cv/collect
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明（如果一起传多个则会都满足的情况才会返回结果，如果不想搜索某条件，则不传该参数） | 必填 |
|---|---|---|---|
| page | int | 第几页 默认1 | 否 |
| limit | int | 每页条数 默认20 | 否 |
| name | string | 姓名 | 否 |
| position_name | string | 职位名称 | 否 |
请求示例
// body 传参示例
{
"page":2, // 第二页
"limit":20, // 每页20条
"name" : "李世星",
"position_name": "开发"
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | cvInfo object | 数据列表 |
cvInfo Obejct
| 参数 | 类型 | 说明 |
|---|---|---|
| cv_id | int | user_cv ID |
| collection_id | int | 收藏简历id |
| cv_avatar | string | 简历头像 |
| cv_name | string | 简历名称 |
| cv_sex_name | string | 性别 |
| cv_educ_name | string | 学历 |
| cv_age | int | 年龄 |
| cv_tel | string | 手机号码 |
| cv_province | string | 省份 |
| cv_city | string | 城市 |
| wish_salary_section | string | 薪资区间 |
| position_name | string | 投递简历职位名称 |
| cv_job_status | string | 求职状态 |
| cv_school | string | 毕业院校 |
| cv_major | string | 专业 |
| project | project Object | 项目经验 |
project
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | project ID |
| company | string | 项目公司 |
| position_name | string | 职位 |
| project | string | 项目表述 |
| start_time | string | 开始时间 |
| end_time | string | 结束时间 |
返回示例
{
"status": 0,
"list": [
{
"cv_id": 167,
"collection_id": 5,
"cv_avatar": "https://static.ijiwei.com/cv/avatar.png",
"cv_name": "豆包",
"cv_sex_name": "女",
"cv_educ_name": "硕士",
"cv_age": 37,
"cv_tel": "13810875748",
"cv_province": "广西壮族自治区",
"cv_city": "南宁市",
"wish_salary_section": "20K-50K",
"position_name": "小小测试投递数据",
"cv_job_status": "在职，看看机会",
"cv_school": "地质大学",
"cv_major": "计算机",
"cv_full_name": "是",
"project": {
"id": 144,
"company": "爱集微",
"position_name": "测试",
"project": "爱玩",
"start_time": "2020.11.01",
"end_time": "至今"
}
}
],
"current_page": 1,
"last_page": 1,
"per_page": 20,
"total": 1
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | |
| 202 |
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
标记简历状态
使用这个接口 标记简历状态为合适不合适
接口地址
/cv/suitable
请求方式
PUT
请求参数 body传参
| 参数 | 类型 | 说明（如果一起传多个则会都满足的情况才会返回结果，如果不想搜索某条件，则不传该参数） | 必填 |
|---|---|---|---|
| cv_log_id | int | 标记投递记录值 | |
| is_suitable | int | 标记状态值 0 不合适 1为合适 |
请求示例
{
"cv_log_id":1942,
"is_suitable":0
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据列表 |
data Obejct
| 参数 | 类型 | 说明 |
|---|---|---|
| cv_log_id | int | 标记投递记录值 |
返回示例
{
"status": 0,
"data": {
"cv_log_id": 1942
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
查看面试邀约
查看面试邀约详情
接口地址
/cv/invited/info
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| cv_log_id | int | 标记投递记录值 | 是 |
请求示例
{
"cv_log_id":1942
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据列表 |
data Obejct
| 参数 | 类型 | 说明 |
|---|---|---|
| cv_info | cv_info Object | 简历详情 |
| invited_info | invited_info Object | 面试邀约详情 |
| invited_id | int | 面试邀约ID |
cv_info
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 简历ID |
| educ_name | String | 学历 |
| name | String | 名称 |
| years | String | 工作年限 |
| sex_name | String | 性别 |
| age | String | 年龄 |
| tel | String | 电话 |
| province | String | 地区 |
| city | String | 城市 |
| wish | String | 期望年薪 |
wish
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 期望 |
| wish_city | String | 期望地点 |
| wish_province | String | 期望职位 |
| wish_salary | String | 期望薪资 |
invited_info
| 参数 | 类型 | 说明 |
|---|---|---|
| company_name | String | 招聘公司名称 |
| interview_time | int | 面试邀约时间 |
| position_name | String | 面试邀约岗位 |
| company_address | String | 面试邀约地址 |
| linkman | String | 面试联系人 |
| phone | String | 面试邀约手机号 |
| intro | String | 面试邀约事宜详情 |
| status_info | String | 面试邀约状态 |
| status | int | 面试邀约状态 |
返回示例
{
"status": 0,
"data": {
"cv_info": {
"id": 142,
"educ_name": "本科",
"name": "Alyss",
"years": "应届生",
"sex_name": "女",
"age": 24,
"tel": "15811288281",
"province": "北京市",
"city": "北京市",
"wish": {
"id": 81,
"wish_city": "北京市",
"wish_province": "产品经理",
"wish_salary": "0 万/年"
}
},
"invited_info": {
"company_name": "于斌有限公司",
"interview_time": "2022-07-12 13:53:18",
"position_name": "测试校招岗位",
"company_address": "北京呀",
"linkman": "刘女士1",
"phone": "13333891144",
"intro": "",
"status_info": "已取消邀请",
"status": 3
},
"invited_id": 2
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
| 2022/09/07 | 李世星 | 修改 新增 invited_info.status、status_info 参数 |
面试邀约
对指定职位投递的单个简历 进行 面试邀约
接口地址
/cv/invited
请求方式
PUT
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| cv_log_id | int | 标记投递记录值 | 必填 |
| is_invited | int | 编辑状态 1为创建和编辑 0为取消面试 | 必填 |
| invited_id | int | 标记投递记录值 | 编辑和取消时必填 创建时不填 |
| phone | int | 面试联系人电话 | 创建编辑时必填 |
| linkman | int | 面试联系人 | 创建编辑时必填 |
| interview_time | int | 面试时间 1657605198 10位时间戳 | 创建编辑时必填 |
| intro | string | 备注 | 创建编辑时必填 |
请求示例
{
"cv_log_id": 1942,
"phone" :13333891144,
"linkman": "刘女士1",
"interview_time": 1657605198,
"intro":"",
"is_invited":1
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据列表 |
data Obejct
| 参数 | 类型 | 说明 |
|---|---|---|
| cv_log_id | int | 标记投递记录值 |
返回示例
{
"status": 0,
"data": {
"cv_log_id": 1942
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
简历控制详情
查看投递简历当前控制详情
接口地址
/cv/deliverstatus
请求方式
GET
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| cv_log_id | int | 标记投递记录值 |
请求示例
{
"cv_log_id":1942,
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 数据列表 |
data Obejct
| 参数 | 类型 | 说明 |
|---|---|---|
| collect | collect Object |
收藏状态 |
| suitable | suitable Object |
标记投递状态 |
| invited | invited Object |
面试邀约状态 |
collect Object
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | 1为 已收藏 0为未收藏 |
| id | int | 如果被收藏显示收藏id |
| is_enable | bool | 当前按钮可点击 |
suitable Object
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | 1为 合适 0为不合适 |
| is_enable | bool | 当前按钮可点击 |
invited Object
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | 1为 待接受 2 已接受 3已取消 4已结束 5已拒绝 |
| is_enable | bool | 当前按钮可点击 |
| id | int | 面试邀约id |
| id_edit | bool | 当前内容是否可编辑 |
返回示例
{
"status": 0,
"data": {
"collect": {
"status": 1,
"is_enable": false
},
"suitable": {
"status": 1,
"is_enable": false
},
"invited": {
"status": 1,
"id": 1,
"is_enable": true,
"id_edit": true
}
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
简历批量导出任务
查看投递简历当前控制详情
接口地址
/cv/download/task
请求方式
POST
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| ids | string | 导出简历 userCV id 不填写就是导出所有 | 否 |
| source | string | 来源，oms后台传oms，emp后台传emp | 是 |
| cv_type | string | 导出简历类型 1为在线简历2为附件简历 | 是 |
| admin_id | int | 后台用户id | 是 |
请求示例
curl --location --request POST '/api/cv/download/task' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6Im9tcyJ9.eyJyb2xlIjpbM10sIm5pY2tuYW1lIjoiXHU2ZDRiXHU4YmQ1XHU4ZDI2XHU1M2Y3IiwiaWQiOiJNUT09IiwiaXNzIjoiT01TQmFzZSIsInN1YiI6Ik9NU0FwaUFjY2VzcyIsImlhdCI6MTY0NTU4Mjg1NSwiZXhwIjoxNjQ2MTg3NjU1fQ.5K2Q6P8-_tUZeKw_O4JeKnf77dSgQcwsXFyuFSUXhxw' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'ids=82,86,20' \
--data-urlencode 'admin_id=1' \
--data-urlencode 'cv_type=1' \
--data-urlencode 'source=pc'
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 导入简历列表 |
返回示例
{
"status":0,
"list":[82,86,20]
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
找回密码相关（pwd）
发送验证码
发送验证码
POST: /api/pwd/send-security-codeResponse Body:
{
"status": 202,
"error": "已发送验证码，请稍后重试"
}
HTTP Method
POST
HTTP Request
/api/pwd/send-security-code
Request Parameters Query
无
Request Parameters Body
| Parameter | Description | Type | Required | Explain |
|---|---|---|---|---|
| type | 请求类型 | Number | 是 | 1: 手机号 2：邮箱 |
| account | 账号 | String | 是 | 手机号/邮箱地址 |
Response Data
Manager Object
| Title | Description | Type | Tips |
|---|---|---|---|
| status | 0为成功 | Number | |
| error | 错误信息 | String |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/11/21 | 李晓东 | 新增 |
重置密码
发送验证码
POST: /api/pwd/send-security-codeResponse Body:
{
"status": 202,
"error": "验证码已使用, 请重新发送"
}
HTTP Method
POST
HTTP Request
/api/pwd/reset
Request Parameters Query
无
Request Parameters Body
| Parameter | Description | Type | Required | Explain |
|---|---|---|---|---|
| type | 请求类型 | Number | 是 | 1: 手机号 2：邮箱 |
| account | 账号 | String | 是 | 手机号/邮箱地址 |
| code | 验证码 | Number | 是 | 验证码 |
| password | 密码 | String | 是 | 密码 |
| confirm_password | 确认密码 | String | 是 | 确认密码 |
Response Data
Manager Object
| Title | Description | Type | Tips |
|---|---|---|---|
| status | 0为成功 | Number | |
| error | 错误信息 | String |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/11/21 | 李晓东 | 新增 |
职位管理模块 position
修改职位
接口地址
/position/{id}
请求方式
PUT
请求参数
BODY
| 参数 | 类型 | 说明 |
|---|---|---|
| position_name | string | 职位名称 |
| intro | string | 职位描述 |
| city | string | 工作地点（城市） |
| province | string | 工作地点（省份） |
| map_code | int | map_code |
| years | int | 要求工作年限 |
| educ | int | 学历要求 |
| salary_min | int | 薪资最小值（万/年） |
| salary_max | int | 薪资最大值（万/年） |
| position_field_id | int | 职能ID |
| active_status | bool | 开启关闭状态 |
请求示例
*/position/{id}*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 职位（Position:Object）列表 |
Position:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| position_name | string | 职位名称 |
| intro | string | 职位描述 |
| position_field | object | Position:field:object职能分类 |
| city | string | 工作地点（城市） |
| years | int | 要求工作年限 |
| educ | int | 学历要求 |
| salary_min | int | 薪资最小值（万/年） |
| salary_max | int | 薪资最大值（万/年） |
| active_status | bool | 状态 |
Position:field:object 职能分类
| 参数 | 类型 | 说明 |
|---|---|---|
| position_id | int | 职位ID |
| position_name | string | 职位名称 |
| field | object | field:object |
field:object
| 参数 | 类型 | 说明 |
|---|---|---|
| field_id | int | 分类ID |
| field_name | string | 分类名称 |
返回示例
{
"status": 0,
"data": {
"id": 38,
"position_name": "主理人-修改后",
"intro": "说点啥-修改后",
"position_field": {
"position_id": 49,
"position_name": "i解耦i加哦加哦就321",
"field": {
"field_id": 109,
"field_name": "BUG修改好了"
}
},
"city": "沈阳市",
"years": "3",
"educ": "4",
"salary_min": 69,
"salary_max": 101,
"active_status": true
}
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 传递参数有误 |
| 202 | 插入失败 |
| 403 | 未授权 |
添加职位
职位在系统中分为两种，一种是HR类型的用户所发布的职位(默认绑定为HR所在的公司)
另一种则是猎头用户所发布的职位，这种职位在发布的时候需要选择所属的公司，即猎头所维护的公司。
但这两种方式都使用这个接口来提供支持，
接口地址
/position
请求方式
POST
请求参数
BODY
| 参数 | 类型 | 说明 |
|---|---|---|
| position_name | string | 职位名称 |
| intro | string | 职位描述 |
| address | object | 地点对象 每个地址 都会生成一个新的职位 |
| years | int | 要求工作年限（0不限，1应届生，2、1~3年，3、3~5年，4、5~10年，5、10年以上，8、双选会） |
| educ | int | 学历要求（0不限，1大专，2本科，3硕士，4博士，5MBA） |
| salary_min | int | 薪资最小值（万/年） |
| salary_max | int | 薪资最大值（万/年） |
| position_field_id | int | 职能分类ID |
| position_id | int | 职能ID |
| company_info | object | Compnay:object 公司信息对象 |
| salary_type | int | 薪资类型 |
| salary_cap | int | 福利多少薪 非必填 默认 12 |
address:object
| 参数 | 类型 | 说明 |
|---|---|---|
| city | string | 工作地点（城市） |
| province | string | 省份 |
Compnay:object
| 参数 | 类型 | 说明 |
|---|---|---|
| customer_type | string | 客户类型 （hr & hunter）参见用户的详情信息 |
| company_id | int | 公司ID （新增页面打开的时候，需要获取当前hr用户所属的公司，或猎头用户维护的公司列表，可以从中获取公司ID） |
请求示例
{
"position_name": "主理人",
"intro": "说点啥",
"address": [
{
"city": "北京市",
"province": "北京市",
"map_code": "1100",
},
{
"city": "天津",
"province": "天津",
"map_code": "1101",
}}
]
"years": "2",
"educ": "1",
"salary_min": 50,
"salary_max": 100,
"position_field_id": 109,
"position_id": 49,
"company_info":{
"customer_type": "hr",
"company_id": 40
}
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 职位（Position:Object）列表 |
Position:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| position_name | string | 职位名称 |
| company_info | object | 职位公司信息（Company:Object）对象 |
| intro | string | 职位描述 |
| position_field | object | Position:field:object职能分类 |
| city | string | 工作地点（城市） |
| years | int | 要求工作年限（0不限，1应届生，2、1~3年，3、3~5年，4、5~10年，5、10年以上） |
| educ | int | 学历要求（0不限，1大专，2本科，3硕士，4博士，5MBA） |
| salary_min | int | 薪资最小值（万/年） |
| salary_max | int | 薪资最大值（万/年） |
| delivery_num | int | 投递数 |
| collect_num | int | 收藏数 |
| updated_time | int | 上次更新时间 (发布时间) |
| owner_name | string | 发布人 |
Company:Object公司信息
| 参数 | 类型 | 说明 |
|---|---|---|
| company_id | int | ID |
| company_name | object | 职位公司信息（Company:Object）对象 |
| logo | string | LOGO |
| capitalization | string | 融资阶段 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
| overview | string | 简介 |
| treatments | array | 福利 （Treatments:Object）对象 |
Treatments:Object 福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 福利名称 |
Position:field:object 职能分类
| 参数 | 类型 | 说明 |
|---|---|---|
| position_id | int | 职位ID |
| position_name | string | 职位名称 |
| field | object | field:object |
field:object
| 参数 | 类型 | 说明 |
|---|---|---|
| field_id | int | 分类ID |
| field_name | string | 分类名称 |
返回示例
{
"status": 0,
"data": [
{
"id": 37,
"position_name": "前端工程师",
"company_info": {
"company_id": 40,
"company_name": "EMP测试HR专用公司",
"logo": "EMP测试HR专用公司",
"capitalization": "EMP测试HR专用公司",
"scale": "EMP测试HR专用公司",
"overview": "EMP测试HR专用公司",
"treatments": [
{
"id": 1,
"treatment_name": "包吃"
},
{
"id": 9,
"treatment_name": "六险一金"
}
]
},
"intro": "要你来，别只会curd",
"position_field": {
"position_id": 1,
"position_name": "互联网22",
"field": {
"field_id": 1,
"field_name": "互联网"
}
},
"city": "北京",
"map_code": "1100",
"years": "1~3年",
"educ": "本科",
"salary_min": 50,
"salary_max": 199,
"delivery_num": 0,
"view_num": 0,
"collect_num": 0,
"updated_time": 1587892189,
"owner_name": "EMP测试HR专用公司",
"active_status": true
},
{
"id": 37,
"position_name": "前端工程师",
"company_info": {
"company_id": 40,
"company_name": "EMP测试HR专用公司",
"logo": "EMP测试HR专用公司",
"capitalization": "EMP测试HR专用公司",
"scale": "EMP测试HR专用公司",
"overview": "EMP测试HR专用公司",
"treatments": [
{
"id": 1,
"treatment_name": "包吃"
},
{
"id": 9,
"treatment_name": "六险一金"
}
]
},
"intro": "要你来，别只会curd",
"position_field": {
"position_id": 1,
"position_name": "互联网22",
"field": {
"field_id": 1,
"field_name": "互联网"
}
},
"city": "天津",
"map_code": "1101",
"years": "1~3年",
"educ": "本科",
"salary_min": 50,
"salary_max": 199,
"delivery_num": 0,
"view_num": 0,
"collect_num": 0,
"updated_time": 1587892189,
"owner_name": "EMP测试HR专用公司",
"active_status": true
}
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 非法的status |
| 403 | 未授权 |
获取职位列表
获取职位列表包含获取暂停的招聘职位，和进行中的招聘职位，都是使用这个接口来获取的数据，
默认每个页面有5条数据。
接口地址
/position
请求方式
GET
请求参数
QUERY STRING
| 参数 | 类型 | 说明 |
|---|---|---|
| search | string | 职位名称 |
| status | string | on(开启)&off（关闭） |
| case | int | 职位类型 1校招 5社招 8双选会 |
| type | int | 职位类别 2实习 1校招 3社招 |
| map_code | int | 职位所在城市 |
| page | int | 页码 |
| limit | int | 每页显示的数量 |
请求示例
支持name模糊查询
*/position?search=开发&status=on&page=1&limit=10*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 职位（Position:Object）列表 |
| current_page | int | 当前页数 |
| last_page | int | 总页数 |
| total | int | 数据总数 |
Position:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| position_name | string | 职位名称 |
| company_name | string | 公司名称 |
| city | string | 工作地点（城市） |
| years | int | 要求工作年限（0不限，1应届生，2、1~3年，3、3~5年，4、5~10年，5、10年以上） |
| educ | int | 学历要求（0不限，1大专，2本科，3硕士，4博士，5MBA） |
| salary_min | int | 薪资最小值（万/年） |
| salary_max | int | 薪资最大值（万/年） |
| delivery_num | int | 投递数 |
| view_num | int | 观看数 |
| updated_time | int | 上次更新时间 |
| active_status | bool | 开启关闭状态 |
返回示例
{
"status": 0,
"list": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 非法的status |
| 202 | 非法分页配置 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/06/30 | 张宏伟 | 新增case字段 |
| 2022/02/10 | 张宏伟 | 修改权限逻辑 |
获取职位详情
获取职位的评论，可以使用limit限制每页条数
接口地址
/position/{id}/comment
请求方式
GET
请求参数
请求示例
*/position/{id}/comment?limit=3*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | Comment（Comment:Object）列表 |
| current_page | int | 当前页码 |
Comment:Object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 用户名 |
| cotent | string | 内容 |
| created_time | int | 时间 |
返回示例
{
"status": 0,
"list": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 非法的status |
获取职位详情
获取职位的详情，用于展示和编辑的时候进行修改，职位详情中的公司信息不需要单独获取
接口地址
/position/{id}
请求方式
GET
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| detail | int | 是否是详细数据 传'yes', 'y', 'on', 'true', 't', '1' 都认为是详细数据 |
请求示例
*/position*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 职位（Position:Object）列表 |
Position:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| position_name | string | 职位名称 |
| company_info | object | 职位公司信息（Company:Object）对象 |
| intro | string | 职位描述 |
| position_field | object | Position:field:object职能分类 |
| city | string | 工作地点（城市） |
| province | string | 工作地点（省份） |
| map_code | int | 工作地点（map_code） |
| years | int | 要求工作年限 传detail 显示为工作年限 否则为id |
| educ | int | 学历要求 传detail 显示为学历要求 否则为id |
| salary_min | int | 薪资最小值（万/年） |
| salary_max | int | 薪资最大值（万/年） |
| salary_type | int | 薪资类型 1 年薪 2月薪 3日薪 4 面议 |
| salary_cap | int | 薪资福利数 默认 12 （12薪） |
| delivery_num | int | 投递数 |
| collect_num | int | 收藏数 |
| updated_time | int | 上次更新时间 (发布时间) |
| owner_name | string | 发布人 |
Company:Object公司信息
| 参数 | 类型 | 说明 |
|---|---|---|
| company_id | int | ID |
| company_name | object | 职位公司信息（Company:Object）对象 |
| logo | string | LOGO |
| capitalization | string | 融资阶段 |
| scale | string | 公司规模 传detail 显示为规模 否则为id |
| overview | string | 简介 |
| treatments | array | 福利 （Treatments:Object）对象 |
Treatments:Object 福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 福利名称 |
Position:field:object 职能分类
| 参数 | 类型 | 说明 |
|---|---|---|
| position_id | int | 职位ID |
| position_name | string | 职位名称 |
| field | object | field:object |
field:object
| 参数 | 类型 | 说明 |
|---|---|---|
| field_id | int | 分类ID |
| field_name | string | 分类名称 |
返回示例
{
"status": 0,
"data": {
"id": 37,
"position_name": "前端工程师",
"company_info": {
"company_id": 40,
"company_name": "EMP测试HR专用公司",
"logo": "http://s.laoyaoba.com/jwImg/4acdda32e555a141.jpg",
"capitalization": "D轮",
"scale": 2,
"overview": "用来给EMP测试",
"treatments": [
{
"id": 1,
"treatment_name": "包吃"
},
{
"id": 9,
"treatment_name": "六险一金"
}
]
},
"intro": "要你来，别只会curd",
"position_field": {
"position_id": 1,
"position_name": "互联网22",
"field": {
"field_id": 1,
"field_name": "互联网"
}
},
"city": "北京",
"years": 2,
"educ": 2,
"salary_min": 50,
"salary_max": 199,
"salary_type" : 1,
"salary_cap": 12,
"active_status": true
}
}
详细版的返回值
{
"status": 0,
"data": {
"id": 37,
"position_name": "前端工程师",
"company_info": {
"company_id": 40,
"company_name": "EMP测试HR专用公司",
"logo": "http://s.laoyaoba.com/jwImg/4acdda32e555a141.jpg",
"capitalization": "D轮",
"scale": "50~99",
"overview": "用来给EMP测试",
"treatments": [
{
"id": 1,
"treatment_name": "包吃"
},
{
"id": 9,
"treatment_name": "六险一金"
}
]
},
"intro": "要你来，别只会curd",
"position_field": {
"position_id": 1,
"position_name": "互联网22",
"field": {
"field_id": 1,
"field_name": "互联网"
}
},
"city": "北京",
"years": "1~3年",
"educ": "本科",
"salary_min": 50,
"salary_max": 199,
"salary_type": 1,
"salary_cap": 12,
"active_status": true,
"delivery_num": 0,
"view_num": 0,
"collect_num": 0,
"publish_time": 1587892189,
"owner_name": "EMP测试HR专用公司"
}
}
Status返回值
| status | 说明 |
|---|---|
| 201 | 非法的id |
| 202 | 找不到对应ID的职位 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/02/10 | 张宏伟 | 修改权限逻辑 |
刷新职位信息
刷新职位的，用于排序职位
接口地址
/position/{id}/refresh
请求方式
PUT
请求示例
/position/443/refresh
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | 职位（Position:Object）更新信息 |
Position:Object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| refresh_at | string | 更新毫秒数 |
返回示例
{
"status": 0,
"data": {
"id": 344,
"refresh_at": 1631870463147
}
}
Status返回值
| status | 说明 | |
|---|---|---|
| 201 | 非法的id | |
| 202 | 当前职位不属于双选会 | |
| 203 | 刷新失败 |
添加取消简历收藏
简历添加取消收藏
接口地址
/position/cv/collect
请求方式
PUT
请求参数 body传参
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| cv_id | string | userCV id is_collection 为1时 必填 | 否 |
| position_id | int | 职位id is_collection 为1时 必填 | 否 |
| collection_id | int | 收藏id is_collection 为0时 必填 | 否 |
| is_collection | int | 收藏 1为收藏 0为取消收藏 | 是 |
请求示例
{
"cv_id": 142, //简历id
"position_id": 398, //职位id
"is_collection": 1, //是否收藏 1为收藏 0为取消收藏
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | Object | 返回数据 |
返回示例
{
"status":0,
"data": {
"cv_id" : 142
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
获取所拥有职位所在城市
获取所拥有职位所在城市
接口地址
/position/citylist
请求方式
GET
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| provinces | Array | 返回数据 |
provinces
| 参数 | 类型 | 说明 |
|---|---|---|
| name | string | 名称 |
| level | int | 级别 |
| code | int | 标识 |
| cities | Array | 区域下的城市 |
cities
| 参数 | 类型 | 说明 |
|---|---|---|
| name | string | Api Code |
| level | int | 级别 |
| code | int | 标识 |
返回示例
{
"status": 0,
"provinces": [
{
"name": "北京市",
"level": "1",
"code": "1100",
"cities": [
{
"name": "北京市",
"level": "1",
"code": "1101"
}
]
}
]
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 201 | 被标记的记录不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
猎头公司模块 position:company
猎头用户新增维护的公司
仅猎头用户可以使用
接口地址
/position/company
请求方式
POST
请求参数
| 参数 | 类型 | 说明 | 是否必填 | 备注 |
|---|---|---|---|---|
| company_name | string | 公司名称 | 是 | |
| company_short | string | 公司简称 | 是 | |
| show_name | string | 对外显示名称 | 是 | |
| logo | string | LOGO | 是 | |
| intro | string | 公司简介 | 是 | |
| capitalization | string | 融资阶段 | 是 | |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） | 是 | |
| treatments | array | Treament:object 福利待遇 [1,2,3,4] | 是 |
请求示例
{
"company_name": "428公司!!修改",
"company_short": "428公司!!修改",
"show_name": "429测试公司!!修",
"logo": "2.jpg",
"intro": "vcbxvcbxvcwer!!修",
"capitalization": "天使轮",
"scale": "7",
"treatments": [37,38]
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 公司（Company:Object）列表 |
Company:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| company_name | string | 公司名称 |
| company_short | string | 公司简称 |
| show_name | string | 对外显示名称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| scale | int | 要求工作年限（0不限，1应届生，2、1~3年，3、3~5年，4、5~10年，5、10年以上） |
| treatments | array | Treament:object 福利待遇 |
Treatment:object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 职位名称 |
返回示例
{
"status": 0,
"data": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | hr用户不可以使用这个接口 |
| 202 | 福利待遇不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/07/02 | 张宏伟 | 新增公司简称字段 |
猎头用户编辑维护的公司
仅猎头用户可以使用
接口地址
/position/company/{id}
请求方式
PUT
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| company_name | string | 公司名称 |
| company_short | string | 公司简称 |
| show_name | string | 对外显示名称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
| treatments | array | Treament:object 福利待遇 [1,2,3,4] |
请求示例
{
"company_name": "428公司!!修改",
"company_short": "428公司!!修改",
"show_name": "429测试公司!!修",
"logo": "2.jpg",
"intro": "vcbxvcbxvcwer!!修",
"capitalization": "天使轮",
"scale": "7",
"treatments": [37,38]
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 公司（Company:Object）列表 |
Company:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| company_name | string | 公司名称 |
| company_short | string | 公司简称 |
| show_name | string | 对外显示名称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| scale | int | 要求工作年限（0不限，1应届生，2、1~3年，3、3~5年，4、5~10年，5、10年以上） |
| treatments | array | Treament:object 福利待遇 |
Treatment:object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 职位名称 |
返回示例
{
"status": 0,
"data": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | hr用户不可以使用这个接口 |
| 202 | 福利待遇不存在 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/07/02 | 张宏伟 | 新增公司简称字段 |
获取维护的公司信息列表
仅猎头用户可以使用
接口地址
/position/company
请求方式
GET
请求参数
QUERY STRING
| 参数 | 类型 | 说明 |
|---|---|---|
| search | string | 职位名称 |
| page | int | 页码 |
| limit | int | 每页个数 |
请求示例
支持name模糊查询
*/position/company?search=华为&<span>limit</span>=10&page=2*
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 公司（Company:Object）列表 |
Company:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| company_name | string | 职位名称 |
| show_name | string | 公司名称 |
| capitalization | string | 融资阶段 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
返回示例
{
"status": 0,
"list": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | hr用户不可以使用这个接口 |
| 202 | query参数有误 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/02/10 | 张宏伟 | 修改权限逻辑 |
获取维护的公司信息详情
仅猎头用户可以使用
接口地址
/position/company/{id}
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 公司（Company:Object）列表 |
Company:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| company_name | string | 职位名称 |
| company_short | string | 公司简称 |
| show_name | string | 公司名称 |
| logo | string | LOGO |
| intro | string | 公司简介 |
| capitalization | string | 融资阶段 |
| scale | int | 公司规模（0不限，1、1~49，2、50~99，3、100~499，4、500~999，5、1000以上） |
| treatments | array | Treament:object 福利待遇 |
Treatment:object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| treatment_name | string | 职位名称 |
返回示例
{
"status": 0,
"list": [
]
}
Status返回值
| status | 说明 |
|---|---|
| 201 | hr用户不可以使用这个接口 |
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/07/02 | 张宏伟 | 新增公司简称字段 |
| 2022/02/10 | 张宏伟 | 修改权限逻辑 |
表单资源接口 resource
系统中全部表单配置数据接口
系统中全部表单配置数据接口
接口地址
/resource
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object |
| 参数 | 类型 | 说明 |
|---|---|---|
| treatments | array | 福利 |
| positions | array | 职位分类 |
| educations | array | 教育程度 |
| scale | array | 公司规模 |
| years | array | 工作年限 |
| deliver_status | array | 投递状态 |
| salary | array | 薪资列表 |
job_status |
array | 求职状态 |
返回示例
{
"status": 0,
"data": {
"treatments": [
{
"id": 41,
"name": "23333"
},
{
"id": 39,
"name": "12321212"
},
{
"id": 38,
"name": "打发打发"
},
{
"id": 37,
"name": "水电费"
},
{
"id": 36,
"name": "是"
},
{
"id": 35,
"name": "地方"
},
{
"id": 34,
"name": "asd"
},
{
"id": 33,
"name": "交通补助1111"
},
{
"id": 32,
"name": "产品测试"
},
{
"id": 16,
"name": "十一险一金1111"
},
{
"id": 1,
"name": "包吃"
}
],
"positions": [
{
"id": 117,
"name": "是",
"position_info": [
{
"id": 60,
"position_name": "我"
}
]
},
{
"id": 116,
"name": "已",
"position_info": [
{
"id": 58,
"position_name": "收纳"
},
{
"id": 59,
"position_name": "出行"
}
]
},
{
"id": 115,
"name": "禁用状态",
"position_info": []
},
{
"id": 114,
"name": "A789",
"position_info": [
{
"id": 56,
"position_name": "Bbbb"
}
]
},
{
"id": 113,
"name": "产品测试",
"position_info": []
},
{
"id": 112,
"name": "ABA1",
"position_info": []
},
{
"id": 111,
"name": "AAA111",
"position_info": [
{
"id": 57,
"position_name": "CCC111"
}
]
},
{
"id": 109,
"name": "BUG修改好了",
"position_info": [
{
"id": 49,
"position_name": "i解耦i加哦加哦就321"
}
]
},
{
"id": 108,
"name": "产品测试9",
"position_info": [
{
"id": 53,
"position_name": "12334"
}
]
},
{
"id": 107,
"name": "产品测试8",
"position_info": [
{
"id": 55,
"position_name": "999999"
}
]
},
{
"id": 106,
"name": "产品测试16",
"position_info": []
},
{
"id": 105,
"name": "产品测试1",
"position_info": [
{
"id": 54,
"position_name": "555556"
}
]
},
{
"id": 104,
"name": "BUG修的咋样了",
"position_info": []
},
{
"id": 103,
"name": "B",
"position_info": [
{
"id": 45,
"position_name": "请求1234555522212244455555555"
}
]
},
{
"id": 102,
"name": "分类的分类",
"position_info": []
},
{
"id": 101,
"name": "有进度反馈一下哈",
"position_info": []
},
{
"id": 100,
"name": "有123",
"position_info": []
},
{
"id": 99,
"name": "有2",
"position_info": []
},
{
"id": 98,
"name": "职能分类的逻辑改好了，可以先看一下1",
"position_info": []
},
{
"id": 94,
"name": "分类567789123",
"position_info": [
{
"id": 51,
"position_name": "方法v发v发v11"
}
]
},
{
"id": 93,
"name": "分类567789",
"position_info": []
},
{
"id": 92,
"name": "分类567855511111",
"position_info": []
},
{
"id": 83,
"name": "分类104555嗯嗯11222111",
"position_info": []
},
{
"id": 81,
"name": "实现下下",
"position_info": []
},
{
"id": 73,
"name": "分类1",
"position_info": [
{
"id": 46,
"position_name": "艰苦艰苦就能看见你可能"
}
]
},
{
"id": 71,
"name": "名称asd",
"position_info": [
{
"id": 48,
"position_name": "看看就很快就会"
}
]
},
{
"id": 69,
"name": "22222222",
"position_info": [
{
"id": 40,
"position_name": "ceshi"
},
{
"id": 44,
"position_name": "新的测!!试"
},
{
"id": 47,
"position_name": "节目离开家离开家"
}
]
},
{
"id": 30,
"name": "芯片10",
"position_info": [
{
"id": 41,
"position_name": "芯片"
}
]
},
{
"id": 8,
"name": "互联网22",
"position_info": [
{
"id": 1,
"position_name": "互联网"
}
]
},
{
"id": 6,
"name": "电子1",
"position_info": [
{
"id": 43,
"position_name": "电子"
}
]
}
],
"educations": [
{
"id": 1,
"name": "大专"
},
{
"id": 2,
"name": "本科"
},
{
"id": 3,
"name": "硕士"
},
{
"id": 4,
"name": "博士"
},
{
"id": 5,
"name": "MBA"
},
{
"id": 9,
"name": "不限"
}
],
"scale": [
{
"id": 1,
"name": "大专"
},
{
"id": 2,
"name": "本科"
},
{
"id": 3,
"name": "硕士"
},
{
"id": 4,
"name": "博士"
},
{
"id": 5,
"name": "MBA"
},
{
"id": 9,
"name": "不限"
}
],
"years": [
{
"id": 1,
"name": "应届生"
},
{
"id": 2,
"name": "1~3年"
},
{
"id": 3,
"name": "3~5年"
},
{
"id": 4,
"name": "5~10年"
},
{
"id": 5,
"name": "10年以上年"
},
{
"id": 9,
"name": "不限"
}
],
"job_status": [
{
"id": 1,
"name": "离职，正在找工作"
},
{
"id": 2,
"name": "在职，暂时不想跳槽"
},
{
"id": 3,
"name": "在职，看看机会"
}
],
"deliver_status": [
{
"id": 1,
"name": "未查看"
},
{
"id": 2,
"name": "已查看"
},
{
"id": 3,
"name": "已发出邀请"
},
{
"id": 4,
"name": "不合适"
}
],
"salary": [
{
"id": 1,
"name": "3K以下"
},
{
"id": 2,
"name": "3K-5K"
},
{
"id": 3,
"name": "5K-10K"
},
{
"id": 4,
"name": "10K-20K"
},
{
"id": 5,
"name": "20k-50K"
},
{
"id": 6,
"name": "50K以上"
}
]
}
}
Status返回值
无
获取系统中的公司福利待遇信息
获取全部的福利待遇
接口地址
/resource/treatment
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 福利待遇（Treatment:Object）列表 |
Treatment:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 待遇名名 |
| label | string | 待遇注释 |
返回示例
{
"status": 0,
"list": [
{
"id": 7,
"name": "餐补",
"label": "每天给吃饭"
},
{
"id": 6,
"name": "五险一金",
"label": "给员工交五险一金"
}
]
}
Status返回值
无
系统中可用的公司规模信息数据接口
获取全部公司规模信息
接口地址
/resource/scale
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 列表 |
object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 名名 |
返回示例
{
"status": 0,
"data": [
{
"id": 1,
"name": "1~49"
},
{
"id": 2,
"name": "50~99"
},
{
"id": 3,
"name": "100~499"
},
{
"id": 4,
"name": "500~999"
},
{
"id": 5,
"name": "1000以上"
},
{
"id": 9,
"name": "不限"
}
]
}
Status返回值
无
系统中可用的受教育信息数据接口
获取全部教育信息
接口地址
/resource/education
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 列表 |
object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 名名 |
返回示例
{
"status": 0,
"data": [
{
"id": 1,
"name": "大专"
},
{
"id": 2,
"name": "本科"
},
{
"id": 3,
"name": "硕士"
},
{
"id": 4,
"name": "博士"
},
{
"id": 5,
"name": "MBA"
},
{
"id": 9,
"name": "不限"
}
]
}
Status返回值
无
系统中可用的工作年限信息数据接口
获取全部工作年限信息
接口地址
/resource/year
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 列表 |
object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 名名 |
返回示例
{
"status": 0,
"data": [
{
"id": 1,
"name": "应届生"
},
{
"id": 2,
"name": "1~3年"
},
{
"id": 3,
"name": "3~5年"
},
{
"id": 4,
"name": "5~10年"
},
{
"id": 5,
"name": "10年以上年"
},
{
"id": 9,
"name": "不限"
}
]
}
Status返回值
无
系统中可用的求职状态信息数据接口
获取全部工作年限信息
接口地址
/resource/jobstatus
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 列表 |
object
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 名名 |
返回示例
{
"status": 0,
"data": [
{
"id": 1,
"name": "离职，正在找工作"
},
{
"id": 2,
"name": "在职，暂时不想跳槽"
},
{
"id": 3,
"name": "在职，看看机会"
}
]
}
Status返回值
无
获取系统中的职能信息
获取全部的职能
接口地址
/resource/position
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 分类（Field:Object）列表 |
Field:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 分类名名 |
positions |
string | 分类拥有的职能 |
Position:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 职能名名 |
返回示例
{
"status": 0,
"data": [
{
"id": 117,
"name": "是",
"positions": [
{
"id": 60,
"treatment_name": "我"
}
]
},
{
"id": 116,
"name": "已",
"positions": [
{
"id": 58,
"treatment_name": "收纳"
},
{
"id": 59,
"treatment_name": "出行"
}
]
},
{
"id": 115,
"name": "禁用状态",
"positions": []
},
{
"id": 114,
"name": "A789",
"positions": [
{
"id": 56,
"treatment_name": "Bbbb"
}
]
},
{
"id": 113,
"name": "产品测试",
"positions": []
},
{
"id": 112,
"name": "ABA1",
"positions": []
},
{
"id": 111,
"name": "AAA111",
"positions": [
{
"id": 57,
"treatment_name": "CCC111"
}
]
},
{
"id": 109,
"name": "BUG修改好了",
"positions": [
{
"id": 49,
"treatment_name": "i解耦i加哦加哦就321"
}
]
},
{
"id": 108,
"name": "产品测试9",
"positions": [
{
"id": 53,
"treatment_name": "12334"
}
]
},
{
"id": 107,
"name": "产品测试8",
"positions": [
{
"id": 55,
"treatment_name": "999999"
}
]
},
{
"id": 106,
"name": "产品测试16",
"positions": []
},
{
"id": 105,
"name": "产品测试1",
"positions": [
{
"id": 54,
"treatment_name": "555556"
}
]
},
{
"id": 104,
"name": "BUG修的咋样了",
"positions": []
},
{
"id": 103,
"name": "B",
"positions": [
{
"id": 45,
"treatment_name": "请求1234555522212244455555555"
}
]
},
{
"id": 102,
"name": "分类的分类",
"positions": []
},
{
"id": 101,
"name": "有进度反馈一下哈",
"positions": []
},
{
"id": 100,
"name": "有123",
"positions": []
},
{
"id": 99,
"name": "有2",
"positions": []
},
{
"id": 98,
"name": "职能分类的逻辑改好了，可以先看一下1",
"positions": []
},
{
"id": 94,
"name": "分类567789123",
"positions": [
{
"id": 51,
"treatment_name": "方法v发v发v11"
}
]
},
{
"id": 93,
"name": "分类567789",
"positions": []
},
{
"id": 92,
"name": "分类567855511111",
"positions": []
},
{
"id": 83,
"name": "分类104555嗯嗯11222111",
"positions": []
},
{
"id": 81,
"name": "实现下下",
"positions": []
},
{
"id": 73,
"name": "分类1",
"positions": [
{
"id": 46,
"treatment_name": "艰苦艰苦就能看见你可能"
}
]
},
{
"id": 71,
"name": "名称asd",
"positions": [
{
"id": 48,
"treatment_name": "看看就很快就会"
}
]
},
{
"id": 69,
"name": "22222222",
"positions": [
{
"id": 40,
"treatment_name": "ceshi"
},
{
"id": 44,
"treatment_name": "新的测!!试"
},
{
"id": 47,
"treatment_name": "节目离开家离开家"
}
]
},
{
"id": 30,
"name": "芯片10",
"positions": [
{
"id": 41,
"treatment_name": "芯片"
}
]
},
{
"id": 8,
"name": "互联网22",
"positions": [
{
"id": 1,
"treatment_name": "互联网"
}
]
},
{
"id": 6,
"name": "电子1",
"positions": [
{
"id": 43,
"treatment_name": "电子"
}
]
}
]
}
Status返回值
无
获取系统中简历投递状态
获取系统中简历投递状态
接口地址
/resource/deliverstatus
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 福利待遇（deliver_status:Object）列表 |
deliver_status:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 状态名称 |
返回示例
{
"status": 0,
"list": [
{
"id": 1,
"name": "未查看"
},
{
"id": 2,
"name": "已查看"
},
{
"id": 3,
"name": "已发出邀请"
},
{
"id": 4,
"name": "不合适"
}
]
}
Status返回值
无
获取系统中薪资列表
获取系统中薪资列表
接口地址
/resource/salary
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| list | array | 福利待遇（salary:Object）列表 |
salary:Object福利
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | |
| name | string | 状态名称 |
返回示例
{
"status": 0,
"list": [
{
"id": 1,
"name": "3k以下"
},
{
"id": 2,
"name": "3K-5K"
},
{
"id": 3,
"name": "5K-10K"
},
{
"id": 4,
"name": "10K-20K"
},
{
"id": 5,
"name": "20K-50K"
},
{
"id": 6,
"name": "50K以上"
}
]
}
Status返回值
无
系统基础设施 tool
图片上传
使用这个接口上传图片。
接口地址
/tool/upload/image
请求方式
POST
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| image | file | 图片文件 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | ImgInfo Object |
ImgInfo
| 参数 | 类型 | 说明 |
|---|---|---|
image |
string | 图片地址 |
返回示例
{
"status": 0,
"data": {
"image": "jwImg/169197ab140cf0fe.jpg"
}
}
Status返回值
| Api code | 说明 |
|---|---|
| 201 | 文件有问题 |
获取当前账号的基础信息
这个接口根据头部信息中的JWT令牌，会返回账号的基础信息。
接口地址
/configuration/account
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | UserInfo Object |
UserInfo
| 参数 | 类型 | 说明 |
|---|---|---|
| account | string | 账号 （登录用的那个） |
| memeber_type | string | 成员类型 hr hunter |
| nickanme | string | 昵称 |
| role_name | int | 角色名称 |
| tele | string | 电话 |
| intro | string | 简介 |
| company_name | string | 公司名称 |
| company_address | string | 公司地址 |
| avatar | string | 用户头像 |
| menu_detail | array | 用户权限菜单 |
role_detail详细参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 当前权限菜单id |
| title | string | 权限菜单名称 |
| parent_id | int | 权限菜单父级id 0为定级 |
| view_code | int | 当前菜单查看权限 0无权限 1所有人 2本人 |
| handle_code | int | 当前菜单操作权限 0无权限 1所有人 2本人 |
| view_power | array | 当前菜单查看权限选项 |
| code | int | 权限代号 |
| power | string | 代号名 |
| isActive | bool | 选中状态 |
| handle_power | array | 当前菜单操作权限选项 （组内字段含义同查看权限） |
| menu | array | 当前菜单所包含的子菜单 |
| isActive | bool | 选中状态 |
返回示例
{
"status": 0,
"data": {
"account": "ceshi0126",
"member_type": "hr",
"nickname": "张",
"email": "1243879519@qq.com",
"avatar": null,
"role_name": "企业管理员",
"menu_detail": [
{
"id": 1,
"title": "我的资料",
"parent_id": 0,
"view_code": 1,
"handle_code": 0,
"rel_id": 1,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": false
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 2,
"title": "个人中心",
"parent_id": 1,
"view_code": 1,
"handle_code": 0,
"rel_id": 2,
"isActive": true
}
]
},
{
"id": 3,
"title": "数据中心",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 3,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 4,
"title": "基础服务",
"parent_id": 3,
"view_code": 1,
"handle_code": 1,
"rel_id": 4,
"isActive": true
}
]
},
{
"id": 5,
"title": "职位管理",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 5,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 6,
"title": "职位列表",
"parent_id": 5,
"view_code": 1,
"handle_code": 1,
"rel_id": 6,
"isActive": true
}
]
},
{
"id": 7,
"title": "简历管理",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 7,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 8,
"title": "简历列表",
"parent_id": 7,
"view_code": 1,
"handle_code": 1,
"rel_id": 8,
"isActive": true
}
]
},
{
"id": 9,
"title": "权限与账号",
"parent_id": 0,
"view_code": 1,
"handle_code": 1,
"rel_id": 9,
"view_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"handle_power": [
{
"code": 1,
"power": "所有人",
"isActive": true
},
{
"code": 2,
"power": "本人",
"isActive": false
}
],
"menu": [
{
"id": 10,
"title": "角色权限",
"parent_id": 9,
"view_code": 1,
"handle_code": 1,
"rel_id": 10,
"isActive": true
},
{
"id": 11,
"title": "账号管理",
"parent_id": 9,
"view_code": 1,
"handle_code": 1,
"rel_id": 11,
"isActive": true
}
]
}
],
"tele": "15133971604",
"intro": null,
"little_intro": null,
"company_name": "emp调试",
"address": "北京市",
"is_double": 0
}
}
Status返回值
| Api code | 说明 |
|---|---|
Log
| 日期 | 作者 | 内容 |
|---|---|---|
| 2021/07/05 | 张宏伟 | 新增职位管理及简历管理查看及操作权限字段 |
| 2022/02/10 | 张宏伟 | 权限逻辑修改 |
获取当前账号的通知消息
这个接口根据头部信息中的JWT令牌，会返回账号的通知消息
接口地址
/notice
请求方式
GET
请求参数
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | object | UserInfo Object |
UserInfo
| 参数 | 类型 | 说明 |
|---|---|---|
| notice | object | 通知 |
| update | object | 更新消息 |
message
| 参数 | 类型 | 说明 |
|---|---|---|
content |
string | 内容 |
type |
int | 类型 |
created_at |
int | 创建时间 |
返回示例
{
"status": 0,
"data": {
"notice": [
{
"content": "欢迎加入EMP",
"type": 1,
"created_at": 1606460922
}
],
"update": [
{
"content": "明天有更新",
"type": 2,
"created_at": 1606460898
}
]
}
}
Status返回值
| Api code | 说明 |
|---|---|
获取接口鉴权JWT令牌
这个接口根据传递的账号和密码，验证并返回JWT令牌。
验证通过后，即可认为这个用户处于登录状态，
在调用系统中的接口时，需要在请求的Header中携带，通过授权获取来的JWT令牌
目前Token有效期为12小时，过期后需要重新获取Token进行登录。
因为不方便在这个接口返回更多用户的详细数据信息，
所以更详细的数据请携带Token去请求账号的基础信息接口。
触发刷新Token的事件，同样记得重新请求基础信息接口重新获取详细信息！
接口地址
/access/token
请求方式
POST
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| account | string | 用户账号 |
| password | string | 用户密码 |
请求示例
{
"account": "user@163.com",
"password": "123456"
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| token | string | token字符串 |
| token_method | string | 加密方式 |
| token_type | string | token 的类型，目前应该固定为 Bearer |
| expire_time | int | 过期时间 |
| last_login | int | 上次用户登录的时间 |
Token 的 Payload 部分可以使用 base64 反向解密获取信息 ，都是脱敏数据，可以使用
但 大部分数据都在获取账号详情接口里有返回，所以没有特殊需求，大可不必使用token中解开的payload中的数据
PAYLOAD
| 参数 | 类型 | 说明 |
|---|---|---|
| user_code | string | 用户标识 （加密数据前端无法解开） |
| case | string | 用户类型， 目前只有两种类型 ( hunter : 猎头 , hr : HR) |
| SaaS | int | 系统中的客户ID （前端应该不会使用） |
| iss | string | 签发人 |
| sub | string | 主题 |
| iat | int | 签发时间 |
| exp | int | 过期时间 |
返回示例
{
"status": 0,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6ImVtcF9hcGkifQ.eyJhY2NvdW50IjoieWljaHV1IiwiY2FzZSI6Imh2bnRlciIsIlNhYVMiOjMwLCJpc3MiOiJFTVBfQkFTRSIsInN1YiI6IkVNUEFwaUFjY2VzcyIsImlhdCI6MTU4NzM1MzYxMCwiZXhwIjoxNTg3Mzk2ODEwfQ.bzX2-sZOMenysLN-Ske6NBSt5SCw35y9IDKXS5of4cE",
"token_method": "HS256",
"token_type": "Bearer",
"expire_time": 1587396810,
"user_last_login": 1587353604
}
Status返回值
| Api code | 说明 |
|---|---|
| 201 | 账号密码错误 |
| 202 | 账户已经被封禁 |
找回密码
/access/retrieve
请求方式
POST
请求参数
| 参数 | 类型 | 必填 | 说明 | 版本 |
|---|---|---|---|---|
| account | string | 是 | 用户账号 | 2022 10月份 迭代 |
| type | int | 是 | 1为手机号 2为 邮箱 | 2022 10月份 迭代 |
请求示例
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | string | Success |
返回示例
{
"status": 0,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6ImVtcF9hcGkifQ.eyJhY2NvdW50IjoieWljaHV1IiwiY2FzZSI6Imh2bnRlciIsIlNhYVMiOjMwLCJpc3MiOiJFTVBfQkFTRSIsInN1YiI6IkVNUEFwaUFjY2VzcyIsImlhdCI6MTU4NzM1MzYxMCwiZXhwIjoxNTg3Mzk2ODEwfQ.bzX2-sZOMenysLN-Ske6NBSt5SCw35y9IDKXS5of4cE",
"data": "SUCCESS"
}
Status返回值
| Api code | 说明 |
|---|---|
| 201 | 账户已经被封禁 |
通知信息接口 notice
获取标题信息通知接口
使用这个接口获取emp标题通知类接口
接口地址
/notice/title
请求方式
GET
请求参数 body传参
无
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 通知信息 |
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | noticeId |
| name | string | 描述 |
| cover | string | 图片 |
| is_jump | string | 是否跳转外部链接 |
| url | string | 外联地址 |
返回示例
{
"status": 0,
"data": [
{
"id": 37,
"name": "小小测试emp消息推送6啊啊钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱钱",
"cover": "http://s.laoyaoba.com/jwImg/042fa0b33bf72849.jpeg",
"is_jump": false,
"url": ""
},
{
"id": 35,
"name": "小小测试emp消息推送4（关联双选会）",
"cover": "http://s.laoyaoba.com/jwImg/fd7eef0217afe0f0.gif",
"is_jump": true,
"url": "https://devwww.laoyaoba.com/workplace#//sxhindex"
},
{
"id": 34,
"name": "小小测试消息推送3（自定义）",
"cover": "http://s.laoyaoba.com/jwImg/babc8dca6a0d94bb.jpg",
"is_jump": true,
"url": "http://47.112.148.159:8780/#/advert?slide_id=34"
},
{
"id": 32,
"name": "小小新建emp消息推送1(外链)",
"cover": "http://s.laoyaoba.com/jwImg/e616972f008b6168.jpeg",
"is_jump": true,
"url": "https://www.laoyaoba.com"
}
]
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 199 | 未加载安全断言中间件 |
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
获取标题信息详情
获取标题信息详情
接口地址
/notice/title
请求方式
GET
请求参数 body传参
{
"slid_id" : 12
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| status | int | Api Code |
| error | string | Api Error Message |
| data | array | 通知信息 |
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | noticeId |
| name | string | 描述 |
| target | int | 平台分类 1:app, 2:小程序, 3: web, 4: h5, 5:emp |
| location | int | 投放位置 1:首页, 2:宣讲会, 3: 双选会,4:小程序广告，5:emp广告，6:app职场页 |
| cover | string | 外联地址 |
| type | int | 类别 1:外链, 2:纯图片 3: 自定义 4:关联双选会 5:关联宣讲会 |
| intro | string | 自定义描述 |
返回示例
{
"status": 0,
"data": {
"id": 12,
"name": "小小测试emp1",
"target": 5,
"location": 5,
"cover": "http://s.laoyaoba.com/jwImg/909df7d8b160a882.jpeg",
"type": 2,
"intro": ""
}
}
Status返回值
| 状态码 | 原因 |
|---|---|
| 199 | 未加载安全断言中间件 |
| 日期 | 作者 | 内容 |
|---|---|---|
| 2022/07/08 | 李世星 | 新增 |
文档使用帮助
在index.html.md文件中进行编辑目录和文档总体结构，然后在includes目录中添加对应的模块。
文档使用Markdown语言排版。
Markdown格式示例
# 标题
## 二级标题
### .......
``` json
代码块
```
表格
表头 | 表头
---------- | -------
内容 | 内容
内容 | 内容
`Something`
表格
| 表头 | 表头 |
|---|---|
| 内容 | 内容 |
| 内容 | 内容 |
无序列表😄
无序列表😜
Json 是没有注释的 避免在json中写注释
Something 高亮
加粗 粗体
横线
下划线
斜体
图片
示例API接口
The above command returns JSON structured like this:
{
"id": 2,
"name": "Max",
"breed": "unknown",
"fluffiness": 5,
"cuteness": 10
}
This endpoint retrieves a specific kitten.
HTTP Request
GET http://example.com/kittens/<ID>
URL Parameters
| Parameter | Description |
|---|---|
| ID | The ID of the kitten to retrieve |