ats-open

签名校验算法说明

签名算法说明

基本信息

Path： /sign

Method： GET

接口描述：

1、聘聘云：没有聘聘云公司ID以及密钥key的,需要联系聘聘云客服或对应的客户联系人 生成对应的 公司ID (companyId)以及密钥 (key)
      测评云：相关接口 需要联系聘聘云客服或对应的客户联系人 生成对应的 公司唯一标识ID (appId)以及密钥 (key)

测试环境接口访问域名：https://opentest.pinpin.com:52126/

2、根据一下算法生成签名 sign .在请求接口的时候将 sign 拼接到参数后面。

sign 生成算法规则如下：
    一、设 所有发送获取者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序）,使用URL
    键值对的格式（key1=value1&key2=value2...）拼接成字符串stringA.
    注意：
            1、参数名ASCII码从小到大排序
            2、参数值为空则不参与签名验证
            3、参数名区分大小写
    二、在stringA 之后 拼接 密钥 key ,中间用 & 符号连接：变为 stringSignTemp=stringA&key。
    三、对字符串stringSignTemp 进行MD5加密处理 生成 签名字符串sign

该文档中所有请求的接口 的签名sign 生成方式均按照以上算法生成！！！！！

以下是java 代码实现 生产sgin

/**
* 签名算法
*
@param map        要参与签名的数据对象
@param privateKey 私钥
****@return** 签名**
*/
**public static String getSign(Map<String, String[]> map, String privateKey) {**
**if (StringUtil.isBlank(privateKey)) {**
return null;
}
ArrayList<String> list = new ArrayList<String>();
for (Map.Entry<String, String[]> entry : map.entrySet()) {
if (entry.getKey().equals("sign")) {
continue;
}
if (!"".equals(entry.getValue()[0])) {
list.add(entry.getKey() + "=" + entry.getValue()[0] + "&");
}
}
int size = list.size();
String[] arrayToSort = list.toArray(new String[size]);
__Arrays.sort(arrayToSort, String.__CASE_INSENSITIVE_ORDER*);
StringBuilder sb = new StringBuilder();
for (int i = 0; i < size; i++) {
sb.append(arrayToSort[i]);
}
sb.append(privateKey);
String result = sb.toString();
result = MD5Util.MD5Encode(result);
return result;
}

请求参数

返回数据

名称	类型	是否必须	默认值	备注	其他信息

登录相关接口

ATS账号登录接口-根据主体信息登录获取帐号信息

基本信息

Path： /auth/account/switch.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
mobile	是		账号
password	是		密码
companyId	是		主体公司ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ loginEmail	string	非必须		登录用户邮箱地址
├─ accountId	number	非必须		账号ID
├─ companyId	number	非必须		公司主体ID
├─ role	number	非必须
├─ employeeCompany	number	非必须
├─ companyName	string	非必须		公司名
├─ sign	string	非必须		密钥
├─ userName	string	非必须		账号名称
├─ roleType	number	非必须		账号对应角色 1 主账号 2 hr 3 用人经理
├─ loginMobile	string	非必须		登录手机号
├─ token	string	非必须		登录token
issuccess	boolean	非必须

ATS账号登录接口-获取主体列表

基本信息

Path： /auth/login.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Body

参数名称	参数类型	是否必须	示例	备注
mobile	text	是		手机号
password	text	是		密码

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ companyId	number	非必须		公司ID
├─ companyName	string	非必须		公司名称
├─ dockerNo	string	非必须		对接人
├─ dockerName	string	非必须		对接人姓名
├─ loginTime	number	非必须		登录时间
├─ roleType	number	非必须		账号角色类型 1 主账号 2 hr 3 用人经理
├─ role	number	非必须
issuccess	boolean	非必须

简历相关接口

根据简历ID获取简历详情

基本信息

Path： /resume/detail.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
sign	是	59a2cd106ef496bb3ce1298b20a27efb	签名
companyId	是	39080	公司ID
resId	是	9703	简历ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		结果状态
message	string	非必须		结果信息
data	object	非必须		数据
├─ baseInfoModel	object	非必须		人选基本信息
├─ id	number	非必须		简历ID
├─ companyId	number	非必须		公司ID
├─ name	string	非必须		人选名
├─ gender	number	非必须		性别（-1：未知，0：女，1：男）
├─ birthYear	number	非必须		出生年
├─ workCity	string	非必须		工作所在地编码
├─ phone	string	非必须		手机号
├─ area	number	非必须		国外手机号 1大陆 2国外
├─ hometownCity	string	非必须		户籍所在地编码
├─ workStatus	number	非必须		工作状态（1：在职，看看新机会，2：在职，急需新工作，3：在职，暂无跳槽打算，4：离职，正在找工作）
├─ email	string	非必须		邮箱
├─ selfIntroduce	string	非必须		自我介绍
├─ highestDegree	number	非必须		最高学历（1：大专以下，2：大专，3：本科，4：硕士，5：博士，6：博士后，7：MBA）
├─ maritalStatus	number	非必须		婚姻状况（0：未知 1：未婚 2：已婚未育，3：已婚已育，4：离异）
├─ headUrl	string	非必须		头像
├─ currentSalary	number	非必须		当前年薪 单位（万元）
├─ salaryType	number	非必须		薪资类型（1：税前，2：税后）
├─ workYears	number	非必须		-1:默认值 0：1年以内，1:1年 ... 13:12年以上
├─ resType	number	非必须		简历类型（1：自定义简历，2：同步推荐简历 3：聘聘发送报告同步 4聘聘云助手同步 5聘聘云购买猎头报告 6面试签到同步 7邮箱抓取简历同步） 第一次为准
├─ visibleFlag	number	非必须		简历联系方式是否可见 0 否1 是
├─ createTime	number	非必须		创建时间
├─ modifyTime	null	非必须		修改时间
├─ wechatCode	string	非必须		微信号
├─ privacyFlag	null	非必须		是否私密 0否 1是
├─ talentType	null	非必须		人才库类型 1在职人才库 2离职人才库 3淘汰人才库
├─ jobIntentionModel	object	非必须		求职意向
├─ id	number	非必须
├─ resId	number	非必须		简历基本信息id
├─ expectSalary	string	非必须		期望薪资
├─ salaryRemark	string	非必须		年薪备注
├─ salaryType	number	非必须		薪资类型（1：非面议，2：面议）
├─ expectIndustry	string	非必须		期望从事行业 多个逗号分隔
├─ expectPosition	string	非必须		期望从事职位 多个逗号分隔
├─ expectCity	string	非必须		期望工作城市 多个逗号分隔
├─ currentSalary	null	非必须		目前年薪
├─ taxType	null	非必须		年薪类型 1税前 2税后
├─ createTime	null	非必须
├─ modifyTime	null	非必须
├─ eduModels	object []	非必须		教育经历	item 类型: object
├─ id	number	非必须
├─ resId	number	非必须		简历基本信息id
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ graduationSchool	string	非必须		毕业学校
├─ unifiedExamFlag	null	非必须		是否统招（0：否，1：是）
├─ degree	number	非必须		学历（1：大专以下，2：大专，3：本科，4：硕士，5：博士，6：博士后，7：MBA）
├─ major	string	非必须		专业
├─ createTime	null	非必须
├─ modifyTime	null	非必须
├─ workModels	object []	非必须		工作经历	item 类型: object
├─ id	number	非必须
├─ resId	number	非必须		简历基本信息id
├─ company	string	非必须		所在公司
├─ jobName	string	非必须		职位名称
├─ companyIndustry	string	非必须		公司行业（编号）
├─ scale	number	非必须		公司规模（1：1-49人；2：50-99人；3:100-499人；4：500-999人；5：1000-9999人；6:10000人以上）
├─ companyIntroduce	string	非必须		公司介绍
├─ workContent	string	非必须		工作内容
├─ workAchievement	string	非必须		工作业绩
├─ dimissionReason	string	非必须		离职理由
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ department	string	非必须		所属部门
├─ reportPerson	string	非必须		汇报对象
├─ underPerson	null	非必须		下属人数
├─ createTime	null	非必须
├─ modifyTime	null	非必须
├─ projectModels	object []	非必须		项目经历	item 类型: object
├─ id	number	必须
├─ resId	number	必须		简历ID
├─ projectName	string	必须		项目名称
├─ projectDuty	string	必须		项目职责
├─ projectDesc	string	必须		项目描述
├─ startYear	number	必须		开始-年
├─ startMonth	number	必须		开始-月
├─ endYear	number	必须		结束-年
├─ endMonth	number	必须		结束-月
├─ createTime	number	必须
├─ modifyTime	number	必须
├─ trainModels	object []	非必须		培训经历	item 类型: object
├─ id	number	非必须
├─ resId	number	非必须		简历ID
├─ trainingName	string	非必须		培训名称
├─ trainingOrganization	string	非必须		培训机构
├─ trainingPlace	string	非必须		培训地点
├─ trainingCertificate	string	非必须		所获证书
├─ trainingDesc	string	非必须		培训描述
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ createTime	number	非必须
├─ modifyTime	number	非必须
├─ productModels	object []	非必须		作品列表	item 类型: object
├─ id	number	非必须
├─ resId	number	非必须		简历基本信息id
├─ productId	number	非必须		附件id
├─ explain	string	非必须		作品说明
├─ name	string	非必须		作品名称
├─ link	string	非必须		作品链接
├─ type	number	非必须		类型（1：附件，2：链接）
├─ languageModels	object []	非必须		语言能力列表	item 类型: object
├─ id	number	非必须
├─ resId	number	非必须		简历基本信息id
├─ language	number	非必须		语言id（1:英语，2：日语，3：其他）
├─ languageProficiency	number	非必须		熟练程度（1：简单沟通，2读写精通 ，3：商务洽谈 ，4：同声翻译）
├─ languageLevel	number	非必须		语言等级：英语（1 :专业四级，2 :专业八级，3 :CET4，4 :CET6，5 :PETS-1B，6 :PETS-1，7 :PETS-2，8 :PETS-3，9 :PETS-4，10:PETS-5）；日语（11:N1，12:N2，13:N3，14:N4，15:N5）
├─ otherLanguage	string	非必须		其他语言能力（字段language为3时有值）
issuccess	boolean	非必须

职位等级相关接口

职级保存

基本信息

Path： /job/rank/save.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22
sign	是	84b7b5c919cc15bf40a5d649529a4e16
rankName	是	职级名
typeName	是	类型
level	是	1
content	是	备注

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	number	非必须		职级记录ID
issuccess	boolean	非必须

职级分页列表获取

基本信息

Path： /job/rank/page/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
current	是	1	页码
pageSize	是	10	条数
companyId	是	22	公司ID
sign	是	26b41caf43dd9748a6b1ef832efb2978	签名

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object []	非必须		列表	item 类型: object
├─ id	number	必须
├─ companyId	number	必须		公司ID
├─ rankName	string	必须		职级名称
├─ typeName	string	必须		职级类型
├─ level	number	必须		等级
├─ content	string	必须		备注
├─ accountId	number	必须		添加人ID
├─ totalRecords	number	非必须		总条数
├─ pageSize	number	非必须		条数
├─ current	number	非必须		当前页
├─ totalPages	number	非必须
├─ topPageNo	number	非必须
├─ previousPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ bottomPageNo	number	非必须
├─ firstPage	boolean	非必须
├─ lastPage	boolean	非必须
issuccess	boolean	非必须

职级合并

基本信息

Path： /job/rank/merge.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
originalId	是		被合并职级ID
newId	是		合并直接ID
companyId	是		公司ID
sign	是		签名

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须		true 成功 false 失败
issuccess	boolean	非必须

获取指定公司下职级信息列表

基本信息

Path： /job/rank/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
excludeId	否	4480	要排除的职级ID
companyId	是	22	公司ID
sign	是	84b7b5c919cc15bf40a5d649529a4e16	签名sign

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	必须
├─ companyId	number	必须		公司ID
├─ rankName	string	必须		职级名
├─ typeName	string	必须		职级类型
├─ level	number	必须		等级
├─ content	string	必须		备注
├─ accountId	number	必须		创建人ID
issuccess	boolean	非必须

职位相关接口

修改职位信息

基本信息

Path： /job/save.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
sign	是	893fd292f2cf76a4bd2a099690286d76	签名
companyId	是	39080	公司ID
id	是	80622	职位ID
status	是	1	状态 1 开放中 2 关闭下线
name	是	Java	职位名
salaryType	是	1	薪资类型1-月薪 2-年薪
minSalary	是	12	最低年薪(万)
maxSalary	是	23	最高年薪(万)
monthSalaryType	是	12	月薪制度 12、十二薪 13、十三薪 14、十四薪 15、十五薪
department	是	开发部	部门
director	是	张三	汇报对象
demand	是	2	招聘人数
underlingNumber	是	4	下属人数
describe	是	Java 后端开发	工作描述
benefits	是	{五险一金}{项目奖金}{周末双休}{交通补助}{餐补}{员工旅游}	职位亮点
workYears	是	2	工作年限 0 不限 ,1 、3年及以下, 2、 3-5年, 3、 5-8年, 4 、8-10年, 5 、10年以上
minAge	是	24	最小年龄
maxAge	是	45	最大年龄
languageRequire	是	1	语言要求 1英语,2日语,3 普通话, 4其他
eduRequire	是	2	学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
nationalUnified	是	1	是否必须统招 0 否 1 是
collegeToUniversity	是	1	是否非专升本 0 否 1 是
businessTravel	是	我们一般要求不出差，根据公司要求看情况实行	出差描述
supplement	是		补充说明
lookContent	是		寻访要求
recruitType	是		招聘类型 1 社招 2 校招

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

修改职位状态上线/下线

基本信息

Path： /job/modify/status.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
sign	是	893fd292f2cf76a4bd2a099690286d76	签名
companyId	是	39080	公司ID
jobId	是	80622	职位ID
status	是	2	状态 1 上线 2 下线

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

根据条件分页获取职位列表

基本信息

Path： /job/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
sign	是	861a16f1a967529408ea3d178eb2b101	签名
companyId	是	39080	公司ID
name	是		名字
status	是		职位状态 1开放中 2已关闭
jobType	是		职位类型 1委托猎头 2普通职位
current	是	1	页码
pageSize	是	10	条数

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		结果状态
message	string	非必须
data	object	非必须		结果数据
├─ list	object []	非必须			item 类型: object
├─ id	number	必须		职位ID
├─ name	string	必须		职位名
├─ companyId	number	必须		公司ID
├─ companyWorkspaceId	number	必须		公司地址ID
├─ categoryId	number	必须		职位职能id
├─ salaryType	number	必须		薪资类型1-月薪 2-年薪
├─ minSalary	number,null	必须		最低年薪(万)
├─ maxSalary	number,null	必须		最高年薪(万)
├─ monthSalaryType	null,number	必须		月薪制度 12、十二薪 13、十三薪 14、十四薪 15、十五薪
├─ department	string	必须		所属部门
├─ director	string	必须		汇报对象
├─ demand	number	必须		招聘人数
├─ underlingNumber	number	必须		下属人数
├─ description	string	必须		工作描述
├─ benefits	string	必须		职位亮点
├─ workYear	number	必须		工作年限 0 不限 ,1 3年及以下, 2 3-5年, 3 5-8年, 4 8-10年, 5 10年以上
├─ minAge	number	必须		最小年龄
├─ maxAge	number	必须		最大年龄
├─ languageRequire	string	必须		语言要求 1英语,2日语,3 普通话, 4其他
├─ eduRequire	number	必须		学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
├─ nationalUnified	number	必须		是否必须统招 0 否 1是
├─ collegeToUniversity	number	必须		是否非专升本 0 否 1 是
├─ status	number	必须		职位状态 1开放中 2已关闭
├─ entrustStatus	number	必须		委托状态 1未委托 2委托中 3委托猎头
├─ businessTravel	string	必须		是否出差描述
├─ lookContent	string	必须		寻访要求
├─ supplement	string	必须		补充说明
├─ recruitType	null	必须		招聘类型 1 社招 2 校招
├─ resPriorityType	null	必须
├─ totalRecords	number	非必须		总条数
├─ pageSize	number	非必须
├─ current	number	非必须		当前页码
├─ totalPages	number	非必须
├─ topPageNo	number	非必须
├─ previousPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ bottomPageNo	number	非必须
├─ firstPage	boolean	非必须
├─ lastPage	boolean	非必须
issuccess	boolean	非必须

职位详情

基本信息

Path： /job/detial.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
jobId	是	1690
companyId	是	39080
sign	是	e976d7f50cd069670d52df741bee3068

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		请求状态码
message	string	非必须		请求返回信息
data	object	非必须		结果数据
├─ id	number	非必须		职位id
├─ name	string	非必须		职位名字
├─ companyId	number	非必须		职位所属公司ID
├─ companyWorkspaceId	number	非必须		职位所属公司地址ID
├─ categoryId	number	非必须		职位职能id
├─ salaryType	number	非必须		薪资类型1-月薪 2-年薪
├─ minSalary	number	非必须		最低年薪(万)
├─ maxSalary	number	非必须		最高年薪(万)
├─ monthSalaryType	null	非必须		月薪制度 12、十二薪 13、十三薪 14、十四薪 15、十五薪
├─ department	string	非必须		所属部门
├─ director	string	非必须		汇报对象
├─ demand	number	非必须		招聘人数
├─ underlingNumber	number	非必须		下属人数
├─ description	string	非必须		工作描述
├─ benefits	string	非必须		职位亮点
├─ workYear	number	非必须		工作年限 0 不限 ,1 3年及以下, 2 3-5年, 3 5-8年, 4 8-10年, 5 10年以上
├─ minAge	null	非必须		要求最小年龄
├─ maxAge	null	非必须		要求最大年龄
├─ languageRequire	string	非必须		语言要求 1英语,2日语,3 普通话, 4其他
├─ eduRequire	number	非必须		学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
├─ nationalUnified	number	非必须		是否必须统招 0 非必须 1 必须
├─ collegeToUniversity	number	非必须		是否非专升本 0 非必须 1 必须
├─ status	number	非必须		职位状态 1开放中 2已关闭
├─ entrustStatus	number	非必须		委托状态 1未委托 2委托中 3委托猎头
├─ businessTravel	string	非必须		是否出差描述
├─ lookContent	string	非必须		寻访要求
├─ supplement	string	非必须		补充说明
├─ recruitType	null	非必须		招聘类型 1 社招 2 校招
issuccess	boolean	非必须

职位职能相关接口

删除职能接口

基本信息

Path： /job/classify/del.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22
sign	是	b67b2f94b272132b6d94c13278e2d232
originalId	是	1

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

根据条件获取职能列表

基本信息

Path： /job/classify/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22	公司ID
sign	是	b67b2f94b272132b6d94c13278e2d232	签名
excludeId	否	38	需要排除的职能ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	必须		职能ID
├─ companyId	number	必须		公司ID
├─ name	string	必须		职能名称
├─ accountId	number	必须		账号ID
issuccess	boolean	非必须

职能保存接口

基本信息

Path： /job/classify/save.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22	公司ID
sign	是	b67b2f94b272132b6d94c13278e2d232	签名
name	是	38	职能名称
id	否		职能ID
accountId	是		账号ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

职能分页列表

基本信息

Path： /job/classify/page/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22	公司ID
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
current	是	1	页码
pageSize	是	2	条数

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object []	非必须			item 类型: object
├─ id	number	必须		职能ID
├─ companyId	number	必须		公司ID
├─ name	string	必须		职能名称
├─ accountId	number	必须		创建人ID
├─ totalRecords	number	非必须
├─ pageSize	number	非必须
├─ current	number	非必须
├─ totalPages	number	非必须
├─ topPageNo	number	非必须
├─ previousPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ bottomPageNo	number	非必须
├─ firstPage	boolean	非必须
├─ lastPage	boolean	非必须
issuccess	boolean	非必须

组织架构相关接口

删除当前（及以下） 架构

基本信息

Path： /company/org/delete.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键

Body

参数名称	参数类型	是否必须	示例	备注
id	text	否	0	主键

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须		调用接口是否成功
issuccess	boolean	非必须

新增修改组织架构

基本信息

Path： /company/org/save.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键

Body

参数名称	参数类型	是否必须	示例	备注
id	text	否	0	修改传入主键
name	text	否	@string	组织名称
parentId	text	否	0	上级部门主键
type	text	否	0	类型 (1, "公司" 、2, "部门")
city	text	否	@string	城市编码 用逗号拼接 例：1,2,3
introduce	text	否	@string	介绍信息

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须		接口是否调用成功
issuccess	boolean	非必须

组织信息批量同步聘聘云系统

基本信息

Path： /api/company/org/batch/save.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Query

参数名称	是否必须	示例	备注
companyId	是		公司ID
sign	是		签名

Body

名称	类型	是否必须	默认值	备注	其他信息
	object []	非必须			item 类型: object
├─ code	string	必须		组织编码，必填
├─ name	string	必须		组织名称 必填
├─ parentCode	string	必须		上级组织编码 非必填

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		200 成功
message	string	非必须		错误信息
data	boolean	非必须		true 成功
issuccess	boolean	非必须

组织架构（所有）

基本信息

Path： /company/org/list.json

Method： GET

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	非必须		数据主键
├─ companyId	number	非必须		公司主键
├─ name	string	非必须		名称
├─ parentId	null	非必须		父节点主键
├─ type	number	非必须		类型 1, "部门"2, "公司"
├─ city	null	非必须		城市编码，逗号拼接
├─ children	object []	非必须		子节点	item 类型: object
├─ id	number	必须
├─ companyId	number	必须
├─ name	string	必须
├─ parentId	number	必须
├─ type	number	必须
├─ city	string	必须
├─ delFlag	null	必须
├─ createTime	number	必须
├─ modifyTime	number	必须
├─ children	object []	必须			item 类型: object
├─ id	number	必须
├─ companyId	number	必须
├─ name	string	必须
├─ parentId	number	必须
├─ type	number	必须
├─ city	string	必须
├─ delFlag	null	必须
├─ createTime	number	必须
├─ modifyTime	number	必须
├─ children	object []	必须			item 类型: object
├─ id	number	必须
├─ companyId	number	必须
├─ name	string	必须
├─ parentId	number	必须
├─ type	number	必须
├─ city	string	必须
├─ delFlag	null	必须
├─ createTime	number	必须
├─ modifyTime	number	必须
├─ children	object []	必须			item 类型: object
├─ id	number	必须
├─ companyId	number	必须
├─ name	string	必须
├─ parentId	number	必须
├─ type	number	必须
├─ city	string	必须
├─ delFlag	null	必须
├─ createTime	number	必须
├─ modifyTime	number	必须
├─ children	string []	必须			item 类型: string
├─		非必须
issuccess	boolean	非必须

招聘需求相关接口

获取HC分页基本信息(可指定时间、状态)

基本信息

Path： /recruitment/demand/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
sign	否	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	否	22	公司主键
accountId	否	1	登录用户主键
status	是		状态(1, "草稿")(2, "未进行")(3, "进行中")(4, "已暂停")(5, "已完成")(6, "已取消")(7, "已超期")
createStartTime	是		创建时间，选择开始结束时间年月日，按创建时间范围筛选
createEndTime	是		创建时间，选择开始结束时间年月日，按创建时间范围筛选

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object []	非必须			item 类型: object
├─ id	number	必须		主键
├─ companyId	number	必须		公司主键
├─ number	string	必须		HC编号
├─ name	string	必须		HC名字
├─ status	null	必须		HC状态
├─ nature	null	必须		职位性质 1 全职 2 兼职 3 实习 4 其他
├─ demandType	null	必须		HC类型
├─ headCount	number	必须		需求人数
├─ reportAccountId	null	必须		汇报对象
├─ startDate	null	必须		开始时间
├─ actualCompleteDate	null	必须		实际完成时间
├─ targetCompleteDate	null	必须		目标完成时间
├─ eduRequire	null	必须		学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
├─ nationalUnified	null	必须		是否必须统招
├─ collegeToUniversity	null	必须		是否非专升本
├─ famousUniversityFlag	null	必须		是否需求985/211名校毕业
├─ salaryType	null	必须		薪资类型1-月薪 2-年薪
├─ minSalary	null	必须		薪资最低值
├─ maxSalary	null	必须		薪资最高值
├─ monthSalaryType	null	必须		月薪制度 0、十二薪 1、十三薪 2、十四薪 3、十五薪 4、十六薪 5、十六薪资以上
├─ description	null	必须		HC描述
├─ linkJobFlag	null	必须		是否关联职位
├─ jobName	null	必须		关联职位名称
├─ entryCount	number	必须		入职人数
├─ chargeAccountName	null	必须		HC负责人
├─ orgName	string	必须		部门名
├─ totalRecords	number	非必须		数据总数
├─ pageSize	number	非必须		每页数量
├─ current	number	非必须		当前页数
├─ totalPages	number	非必须		总页数
├─ previousPageNo	number	非必须
├─ bottomPageNo	number	非必须
├─ topPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ firstPage	boolean	非必须
├─ lastPage	boolean	非必须
issuccess	boolean	非必须

新增修改HC

基本信息

Path： /recruitment/demand/save.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键

Body

参数名称	参数类型	是否必须	示例	备注
id	text	否		HC主键，修改时传入
approveFlowId	text	否	0	审批流主键
principalIds	text	否	@string	HC负责人主键，逗号拼接
jobRanks	text	否	@string	职位级别主键, 逗号拼接
number	text	否	@string	编号
name	text	否	@string	名称
nature	text	否	0	职位性质 1 全职 2 兼职 3 实习 4 其他
demandType	text	否	0	需求类型 1、计划内 2、计划外
headCount	text	否	0	招聘人数
orgId	text	否	0	组织架构主键
reportAccountId	text	否	0	汇报对象主键
actualCompleteDate	text	否	0	实际完成时间
targetCompleteDate	text	否	0	目标完成时间
eduRequire	text	否	0	学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
nationalUnified	text	否	0	是否必须统招
collegeToUniversity	text	否	0	是否非专升本
famousUniversityFlag	text	否	0	是否需求985/211名校毕业
salaryType	text	否	0	薪资类型1-月薪 2-年薪
minSalary	text	否	0.111111	最小薪资
maxSalary	text	否	0.111111	最大薪资
monthSalaryType	text	否	0	月薪制度 0、十二薪 1、十三薪 2、十四薪 3、十五薪 4、十六薪 5、十六薪资以上
companyWorkspaceId	text	否	0	公司地址主键
description	text	否	@string	需求描述

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须		接口是否调用成功
issuccess	boolean	非必须

艾华招聘需求保存

基本信息

Path： /recruitment/demand/third/save.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Body

参数名称	参数类型	是否必须	示例	备注
companyId	text	是	39080	公司Id
appId	text	是	81e27154d63971cc85b7c14401e5e926	对接公司Key
demandType	text	是	1	招聘需求类型1-工程师，2-月度招聘，3-岗位调动，4-复工申请，5-入职追踪流程
demandJson	text	是	{"xm":"","gh":"","drbmbm":"","drbm":""}	需求内容JSON
sign	text	是	81e27154d63971cc85b7c14401e5dasd	签名
accountId	text	是	49695	操作人Id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

获取HC基本信息列表

基本信息

Path： /recruitment/demand/simple/list.json

Method： GET

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键
jobId	是	0	职位主键
keyword	是	@string	搜索关键字

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ entryNumber	number	非必须		入职人数
├─ entryRelationFlag	number	非必须		是否强制关联招聘需求
├─ id	number	非必须		HC主键
├─ companyId	number	非必须		所属公司主键
├─ number	string	非必须		HC编码
├─ name	string	非必须		HC名称
├─ status	number	非必须		HC状态
├─ headCount	number	非必须		招聘人数

获取HC状态数量(可指定时间)

基本信息

Path： /recruitment/demand/count.json

Method： GET

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ status	number	必须		状态(1, "草稿")(2, "未进行")(3, "进行中")(4, "已暂停")(5, "已完成")(6, "已取消")(7, "已超期")
├─ count	null	必须		对应数量
issuccess	boolean	非必须

获取HC详情

基本信息

Path： /recruitment/demand/info.json

Method： GET

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键
demandId	是		HC主键

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ approveFlowId	number	非必须		审批流主键
├─ principalIds	string	非必须		招聘负责人主键，逗号拼接，页面保存时传参用
├─ jobRanks	string	非必须		职位级别主键, 逗号拼接，页面保存时传参用
├─ principalNameList	string []	非必须		招聘负责人，详情回显	item 类型: string
├─		非必须
├─ jobRandNameList	string []	非必须		职位级别，详情回显	item 类型: string
├─		非必须
├─ id	number	非必须		招聘需求主键
├─ companyId	number	非必须
├─ number	string	非必须		编码
├─ name	string	非必须		名称
├─ status	number	非必须		状态 1、草稿 2、未进行 3、 进行中 4 已暂停 5、 已完成 6、 已取消 7、已超期
├─ nature	number	非必须		职位性质 1 全职 2 兼职 3 实习 4 其他
├─ demandType	number	非必须		需求类型 1、计划内 2、计划外
├─ headCount	number	非必须		招聘人数
├─ orgId	number	非必须		部门主键
├─ reportAccountId	number	非必须		汇报对象主键
├─ startDate	number	非必须		开始时间
├─ targetCompleteDate	number	非必须		目标完成时间
├─ eduRequire	number	非必须		学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
├─ nationalUnified	number	非必须		是否必须统招
├─ collegeToUniversity	number	非必须		是否非专升本
├─ famousUniversityFlag	number	非必须		是否需求985/211名校毕业
├─ salaryType	number	非必须		薪资类型1-月薪 2-年薪
├─ minSalary	number	非必须		薪资最小值
├─ maxSalary	number	非必须		薪资最大值
├─ monthSalaryType	number	非必须		月薪制度 0、十二薪 1、十三薪 2、十四薪 3、十五薪 4、十六薪 5、十六薪资以上
├─ companyWorkspaceId	number	非必须		公司地址id
├─ description	string	非必须		需求描述
├─ linkJobFlag	number	非必须		是否关联职位

OFFER相关相关接口

发送OFFER

基本信息

Path： /recommend/handle/offer.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键

Body

参数名称	参数类型	是否必须	示例	备注
entryTime	text	否	0	入职时间
internshipSalary	text	否	@string	实习薪资 单位元
formalSalary	text	否	@string	正式薪资工资
salaryType	text	否	0	1 单位月薪（元） 2 单位年薪(万元)
probationPeriod	text	否	0	实习期 1、1月 2、 2月 3、 3月...
emailTemplateId	text	否	0	邮件模板主键
emailTitle	text	否	@string	邮件标题
emailContent	text	否	@string	邮件内容
fileIds	text	否	@string	offer附件ID 逗号隔开
resEmail	text	否	@string	人选邮箱
ccEmails	text	否	@string	抄送邮箱
approveFlowId	text	否	0	审批流程id
resPhone	text	否	@string	人选手机号
recruitmentDemandId	text	否	0	关联HC主键

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		接口是否调用成功
message	string	非必须
data	number	非必须

接收/拒绝OFFER

基本信息

Path： /recommend/handle/offer/feedback.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键

Body

参数名称	参数类型	是否必须	示例	备注
recommendId	text	是	0	订单主键
offerId	text	是	0	OFFER主键
type	text	是	0	1-接受，2-拒绝

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		接口是否调用成功
message	string	非必须
data	number	非必须

获取OFFER详情(含附件)

基本信息

Path： /recommend/offer.json

Method： GET

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
recommendId	是		订单id
sign	是	0e2f7810cfb00327d2b23542d7ec51a5	签名
companyId	是	22	公司主键
accountId	是	1	登录用户主键

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ id	number	非必须		OFFER主键
├─ recommendId	number	非必须		订单主键
├─ entryDate	number	非必须		入职日期(时间戳)
├─ internshipSalary	string	非必须		实习薪资 单位元
├─ formalSalary	string	非必须		正式薪资工资
├─ salaryType	number	非必须		1 单位月薪（元） 2 单位年薪(万元)
├─ probationPeriod	number	非必须		实习期（试用期） 1、1月 2、 2月 3、 3月...
├─ files	string []	非必须		OFFER附件	item 类型: string
├─		非必须
issuccess	boolean	非必须

公司地址相关接口

公司地址列表接口

基本信息

Path： /company/workplace/list

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22	公司ID
sign	是	b67b2f94b272132b6d94c13278e2d232	签名

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	必须		地址ID
├─ companyId	number	必须		公司ID
├─ city	string	必须		城市编码
├─ address	string	必须		详细地址
issuccess	boolean	非必须

人才库相关相关接口

POST 查询人才库列表

基本信息

Path： /resume/library/list.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
sysType	是		所属系统 1-社招；2-校招
entryLibraryFlag	否		true 父级'在职人才库'不判断权限 false 正常走权限
companyId	是		公司ID
sign	是		签名

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	非必须		人才库id
├─ companyId	number	非必须		公司id
├─ parentId	number	非必须		上级人才库id 如果是第一级 此值为0
├─ name	string	非必须		人才库名称
├─ sysFlag	number	非必须		是否默认 0否 1是
├─ publicFlag	number	非必须		1-公开，0-保密
├─ createTime	number	非必须		创建时间
├─ modifyTime	null	非必须		更新时间
├─ count	number	非必须		简历数量
├─ sysType	number	非必须		所属系统 1-社招；2-校招
├─ accountIds	null	非必须		保密可见人账号id集合
├─ children	object []	非必须		子集人才库集合	item 类型: object
├─ id	number	必须
├─ companyId	number	必须
├─ parentId	number	必须
├─ name	string	必须
├─ sysFlag	number	必须
├─ publicFlag	number	必须
├─ createTime	number	必须
├─ modifyTime	null	必须
├─ count	null,number	必须
├─ sysType	number	必须
├─ accountIds	null	必须
├─ children	object []	必须			item 类型: object
├─ id	number	非必须
├─ companyId	number	非必须
├─ parentId	number	非必须
├─ name	string	非必须
├─ sysFlag	number	非必须
├─ publicFlag	number	非必须
├─ createTime	number	非必须
├─ modifyTime	null	非必须
├─ count	null	非必须
├─ sysType	number	非必须
├─ accountIds	null	非必须
├─ children	string []	非必须			item 类型: string
├─		非必须
issuccess	boolean	非必须

招聘官网相关接口

指定招聘官网的职位信息

基本信息

Path： /website/job/info.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
websiteId	是	426
jobId	是	82427

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ id	number	非必须		职位ID
├─ jobName	string	非必须		职位名
├─ department	null	非必须		所属部门
├─ categoryId	number	非必须		职位职能id
├─ address	null	非必须		工作地点详细地址
├─ city	null	非必须		工作地点城市最后一级没有返回上级
├─ demand	number	非必须		招聘人数
├─ eduRequire	null	非必须		学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
├─ workYear	null	非必须		工作年限 0 不限 ,1 3年及以下, 2 3-5年, 3 5-8年, 4 8-10年, 5 10年以上
├─ minSalary	null	非必须		最低年薪(万)
├─ maxSalary	null	非必须		最高年薪(万)
├─ salaryType	number	非必须		薪资类型1-月薪 2-年薪
├─ monthSalaryType	null	非必须		月薪制度
├─ modifyTime	number	非必须
├─ describe	string	非必须		职位描述
├─ introduce	string	非必须		公司介绍
├─ companyId	null	非必须
├─ sysType	number	非必须		系统类型 1社招 2校招
├─ jobClassifyId	null	非必须
├─ jobClassifyName	null	非必须		职能类别
├─ jobRankIds	null	非必须
├─ jobRankNames	null	非必须		职级
issuccess	boolean	非必须

指定招聘官网职位列表

基本信息

Path： /website/job/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
websiteId	是	426	官网ID
keyWord	否		关键字
cityCode	否		城市编码

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object []	非必须			item 类型: object
├─ id	number	必须		职位ID
├─ jobName	string	必须		职位名
├─ department	string,null	必须		所属部门
├─ categoryId	number	必须		职位职能id
├─ address	null	必须		工作地点详细地址
├─ city	null	必须		工作地点城市最后一级没有返回上级
├─ demand	number	必须		招聘人数
├─ eduRequire	null	必须		学历要求 0不限 2、大专以上 3、本科及以上 4、硕士及以上 5、博士及以上
├─ workYear	null	必须		工作年限 0 不限 ,1 3年及以下, 2 3-5年, 3 5-8年, 4 8-10年, 5 10年以上
├─ minSalary	number,null	必须		最低年薪(万)
├─ maxSalary	number,null	必须		最高年薪(万)
├─ salaryType	number	必须		薪资类型1-月薪 2-年薪
├─ monthSalaryType	number,null	必须		月薪制度
├─ modifyTime	number	必须
├─ describe	string	必须		职位描述
├─ introduce	string	必须		公司介绍
├─ companyId	null	必须		公司ID
├─ sysType	number	必须		系统类型 1社招 2校招
├─ jobClassifyId	null	必须
├─ jobClassifyName	null	必须		职能类别
├─ jobRankIds	null	必须
├─ jobRankNames	null	必须		职级
├─ totalRecords	number	非必须
├─ pageSize	number	非必须
├─ current	number	非必须
├─ totalPages	number	非必须
├─ topPageNo	number	非必须
├─ previousPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ bottomPageNo	number	非必须
├─ firstPage	boolean	非必须
├─ lastPage	boolean	非必须
issuccess	boolean	非必须

候选人相关接口

POST 人选操作入职

基本信息

Path： /recommend/handle/entry.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
orgId	否	组织ID
recommendId	是	订单id
entryDate	否	入职日期 yyyyMMddd的时间戳
probationPeriod	否	试用期 1-12个月
officialDat	否	转正日期 1-12个月
resLibraryId	否	归档人才库id	候选人默认归档至“找人才”下企业在职人才库
recruitmentDemandId	否	招聘需求id
status	否	1 提前转正，2 正常转正，3 延期转正
id	否	入职id 编辑入职信息的时候传
companyId	是	公司id
sign	是	签名
accountId	是	账号id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		"200"
message	string	非必须		"成功"
data	boolean	非必须		true
issuccess	boolean	非必须		true

POST 招聘流程订单列表

基本信息

Path： /recommend/list.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
companyId	是	公司id
sign	是	签名
accountId	是	账号id
recruitProcessId	否	流程id
recruitStageId	否	阶段id
current	是	页码
pageSize	是	条数	最多100条
sysType	是	1社招 2校招

返回数据

名称	类型	是否必须	默认值	备注	其他信息
SUCCESS_STATUS	string	非必须
SUCCESS_MESSAGE	string	非必须
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object	非必须
├─ id	number	非必须		订单id
├─ companyId	number	非必须		公司id
├─ resId	number	非必须		简历id
├─ jobId	number	非必须		职位id
├─ operateAuth	number	非必须		操作权限
├─ interviewDate	string	非必须		面试时间
├─ entryDate	string	非必须		入职时间
├─ source	number	非必须		渠道 1 猎头 2 自主添加
├─ remark	object	非必须		备注
├─ remarkId	number	非必须		备注id
├─ content	string	非必须		备注内容
├─ createTime	number	非必须		创建时间
├─ accountId	number	非必须		操作人id
├─ accountName	string	非必须		操作人名称
├─ resumeName	string	非必须		人选名
├─ gender	number	非必须		性别 0女 1难
├─ workYear	number	非必须		工作年限
├─ startWorkDate	string	非必须		工作开始时间
├─ seniority	number	非必须		工龄
├─ degree	number	非必须		学历
├─ headUrl	string	非必须		头像
├─ age	number	非必须		年龄
├─ birthYear	number	非必须		出生年
├─ maritalStatus	number	非必须		婚姻状况
├─ resEmail	string	非必须		邮箱
├─ jobName	string	非必须		职位名称
├─ userId	number	非必须		账号id
├─ createTime	number	非必须		创建时间
├─ modifyTime	number	非必须		更新时间
├─ recomDate	number	非必须		推荐时间
├─ resumeFeedBack	number	非必须		人选反馈
├─ interviewTime	number	非必须		面试时间
├─ entryTime	number	非必须		入职时间
├─ processTime	number	非必须		流程时间
├─ showUrl	string	非必须		头像url
├─ mbtiEvaluation	number	非必须		测评标识 0 发起过 未回答 1 发起过已回答 2 未发起过
├─ mbtiId	number	非必须		测评记录id
├─ suveryFlag	number	非必须		背调结果 0未创建 1已创建 2已完成 3授权失败
├─ surveyId	string	非必须		背调ID
├─ resPhone	string	非必须		手机号
├─ supplierHunterId	number	非必须		猎头id
├─ companySupplierId	number	非必须		供应商id
├─ supplierHunterName	string	非必须		推荐猎头名称
├─ resCreateTime	number	非必须		简历创建时间
├─ recruitStageId	number	非必须		阶段id
├─ stageType	number	非必须		阶段ID类型
├─ stageName	string	非必须		阶段名
├─ offerFlag	number	非必须		0 无offer 1 有offer
├─ recommendOfferId	number	非必须		offer记录id 为null 说明没有offer
├─ recentWork	object	非必须		最近工作经历
├─ id	number	非必须		主键id
├─ company	string	非必须		所在公司
├─ jobName	string	非必须		职位名称
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ internshipFlag	number	非必须		实习标签 0 非实习 1 实习
├─ recentEdu	object	非必须		最近教育经历
├─ id	number	非必须		主键id
├─ resId	number	非必须		简历基本信息id
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ graduationSchool	string	非必须		毕业学校
├─ degree	number	非必须		学历（1：大专以下，2：大专，3：本科，4：硕士，5：博士，6：博士后，7：MBA）
├─ major	string	非必须		专业
├─ recomName	string	非必须		推荐人姓名
├─ recomPhone	string	非必须		推荐人手机号
├─ resType	number	非必须		简历类型
├─ totalRecords	number	非必须
├─ pageSize	number	非必须
├─ current	number	非必须
├─ totalPages	number	非必须

POST 操作下一阶段

基本信息

Path： /recommend/handle/jump/stage.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
recommendId	是	订单id	订单id
companyId	是	公司id	公司id
sign	是	签名	签名id
accountId	是	账号id	账号id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		"200"
message	string	非必须		"成功"
data	boolean	非必须		true
issuccess	boolean	非必须		true

POST 查询候选人列表

基本信息

Path： /resume/search/list.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
companyId	是		公司id
accountId	是		账号id
groupId	否		分组id
highestDegree	否		学历 1大专及以上 2本科及以上 3硕士及以上 4MBA及以上 5博士及以上 6初中及以上 7高中及以上
minAge	否		最低年龄
maxAge	否		最高年龄
gender	否		性别 0女 1男
workYears	否		工作年限 -1:默认值 0：1年以内，1:1年 ... 13:12年以上
minCurrentSalary	否		目前年薪 最低
maxCurrentSalary	否		目前年薪 最高
keyWords	否		关键词 支持手机号姓名关键词搜索
resLibraryId	否		人才库id
current	是		页码
pageSize	是		条数
sign	是		签名
sysType	是	所属系统 1-社招；2-校招	所属系统 1-社招；2-校招

返回数据

名称	类型	是否必须	默认值	备注	其他信息
SUCCESS_STATUS	string	非必须
SUCCESS_MESSAGE	string	非必须
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object	非必须
├─ resumeId	number	非必须		简历id
├─ companyId	number	非必须		公司id
├─ headUrl	string	非必须		头像
├─ name	string	非必须		姓名
├─ gender	number	非必须		性别（-1：未知，0：女，1：男）
├─ workYears	number	非必须		-1:默认值 0：1年以内，1:1年 ... 13:12年以上
├─ seniority	number	非必须		工龄 计算后
├─ birthYear	number	非必须		出生年
├─ age	number	非必须		年龄
├─ workStatus	number	非必须		工作状态（1：在职，看看新机会，2：在职，急需新工作，3：在职，暂无跳槽打算，4：离职，正在找工作）
├─ expectCitys	string []	非必须		期望城市	item 类型: string
├─		非必须
├─ workExperiences	object []	非必须		工作经历	item 类型: object
├─ id	number	非必须		主键id
├─ resId	number	非必须		简历基本信息id
├─ company	string	非必须		所在公司
├─ companyName	string	非必须		所在公司
├─ jobName	string	非必须		职位名称
├─ companyIndustry	string	非必须		公司行业（编号）
├─ scale	number	非必须		公司规模（1：1-49人；2：50-99人；3:100-499人；4：500-999人；5：1000-9999人；6:10000人以上）
├─ companyIntroduce	string	非必须		公司介绍
├─ workContent	string	非必须		工作内容
├─ workAchievement	string	非必须		工作业绩
├─ dimissionReason	string	非必须		离职理由
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ department	string	非必须		所属部门
├─ reportPerson	string	非必须		汇报对象
├─ underPerson	number	非必须		下属人数
├─ userId	number	非必须		用户id
├─ internshipFlag	number	非必须		实习标签 0 非实习 1 实习
├─ createTime	number	非必须		创建时间
├─ modifyTime	number	非必须		更新时间
├─ educationExperiences	object []	非必须		教育经历	item 类型: object
├─ id	number	非必须		主键id
├─ resId	number	非必须		简历基本信息id
├─ startYear	number	非必须		开始-年
├─ startMonth	number	非必须		开始-月
├─ endYear	number	非必须		结束-年
├─ endMonth	number	非必须		结束-月
├─ graduationSchool	string	非必须		毕业学校
├─ unifiedExamFlag	number	非必须		是否统招（0：否，1：是）
├─ degree	number	非必须		学历（1：大专以下，2：大专，3：本科，4：硕士，5：博士，6：博士后，7：MBA）
├─ major	string	非必须		专业
├─ userId	number	非必须		用户id
├─ createTime	number	非必须		创建时间
├─ modifyTime	number	非必须		更新时间
├─ modifyTime	number	非必须		更新时间
├─ createTime	number	非必须		创建时间
├─ reportFlag	number	非必须		是否有推荐报告(购买猎头报告+猎头推荐报告) 0 没有 1 有
├─ reportRecommendId	number	非必须		推荐报告h端id
├─ recommendId	number	非必须		订单id
├─ resType	number	非必须		简历类型（1：自定义简历，2：同步推荐简历） 第一次为准
├─ visibleFlag	number	非必须		简历联系方式是否可见 0 没有 1 有
├─ intentionCommunicationType	number	非必须		意向沟通类型 1发起意向沟通 2意向沟通中 3再次发起意向沟通
├─ source	number	非必须		订单渠道 1 猎头 2 自主添加
├─ phone	string	非必须		人选手机号
├─ companySupplierId	number	非必须		供应商id
├─ supplierHunterId	number	非必须		猎头id
├─ recruitProcessId	number	非必须		流程id
├─ recruitStageId	number	非必须		阶段id
├─ stageName	string	非必须		阶段名称
├─ stageType	number	非必须		阶段类型
├─ interviewTime	number	非必须		面试时间
├─ resEmail	string	非必须		人选邮箱
├─ backgroundId	string	非必须		背调id
├─ jobName	string	非必须		职位名称
├─ jobId	number	非必须		职位id
├─ intentionStatus	number	非必须		1：无报告，2：有报告未发送，3：已发送
├─ accountId	number	非必须		简历创建人id
├─ accountName	string	非必须		简历创建人名称
├─ protectFlag	number	非必须		简历是否人选保护 0否 1是
├─ protectType	number	非必须		人选保护类型：1候选人锁定 2招聘流程锁定
├─ protectTime	number	非必须		人选保护截止时间
├─ protectRecommendCreateTime	number	非必须		订单创建时间(流程发起时间)
├─ protectRecommendAccountId	number	非必须		订单发起人（流程发起人）
├─ protectRecommendAccountName	string	非必须		订单发起人姓名
├─ protectJobId	number	非必须		被保护的职位id
├─ protectJobName	string	非必须		被保护的职位名称
├─ protectRecruitStageId	number	非必须		受保护订单阶段
├─ protectStageName	string	非必须		受保护订单阶段名称
├─ resLibraryId	number	非必须		人才库id
├─ recomResult	number	非必须		订单状态 1 在职 2 离职 3 淘汰
├─ interviewAppraiseTemplateId	number	非必须		面试官评价模板id
├─ totalRecords	number	非必须		总记录数
├─ pageSize	number	非必须		条数
├─ current	number	非必须		当前页
├─ totalPages	number	非必须		总页数

POST 获取招聘订单信息

基本信息

Path： /recommend/info.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
companyId	是	公司id	公司id
sign	是	签名	签名
accountId	是	账号id	账号id
recommendId	是	流程id	订单id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
SUCCESS_STATUS	string	非必须
SUCCESS_MESSAGE	string	非必须
status	string	非必须
message	string	非必须
data	object	非必须
├─ id	number	非必须		订单id
├─ resId	number	非必须		简历id
├─ jobId	number	非必须		职位id
├─ jobName	string	非必须		职位名称
├─ companyId	number	非必须		公司id
├─ source	number	非必须		渠道 1 猎头 2 自主添加
├─ entryTime	string	非必须		入职时间
├─ remark	string	非必须		备注
├─ createTime	number	非必须		创建时间
├─ accountName	string	非必须		订单发起人
├─ accountId	number	非必须		订单发起人id
├─ recruitProcessId	number	非必须		流程id
├─ recruitStageId	number	非必须		阶段id
├─ recomResult	number	非必须		1 在职 2 离职 3 淘汰
├─ backgroundId	string	非必须		背调id
├─ interviewTime	number	非必须		面试时间
├─ hiringManager	string	非必须		职位负责人
├─ resName	string	非必须		人选姓名
├─ resMobile	string	非必须		人选手机号

POST 转正信息保存

基本信息

Path： /recommend/handle/result/entry/save.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
officialDate	是	转正日期yyyyMMdd 时间戳
remark	否	转正说明
probationPeriod	是	试用期 1、1月 2、 2月 3、 3月...12个月
entryDate	是	入职日期yyyyMMdd时间戳 例如1660060800000
recommendId	是	订单id
companyId	是	公司id
sign	是	签名
accountId	是	账号id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		"200"
message	string	非必须		成功
data	boolean	非必须		true
issuccess	boolean	非必须		true

获取待入职阶段的订单信息

基本信息

Path： /api/recommend/stage/page.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是		公司ID
sign	是		签名，签名算法看算法介绍
current	是	1	页码
pageSize	是	20	条数
startDate	否	时间戳	开始时间-订单创建时间
endDate	否	时间戳	结束时间-订单创建时间

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		状态码 成功200
message	string	非必须		返回信息
data	object	非必须
├─ list	object []	非必须		数据	item 类型: object
├─ companyId	number	非必须		公司ID
├─ recommendId	number	非必须		订单ID
├─ jobName	string	非必须		职位名
├─ createTime	number	非必须		订单创建时间
├─ resInfo	object	非必须		人选信息
├─ resId	number	非必须		人选ID
├─ mobile	string	非必须		手机号
├─ name	null	非必须		姓名
├─ email	string	非必须		邮箱
├─ idCard	null	非必须		身份证
├─ birthYear	number	非必须		出生年
├─ startWorkDate	string	非必须		开始工作时间 yyyyMM
├─ lastSchoolName	string	非必须		最新的教育经历-学校名
├─ lastMajor	string	非必须		最新的教育经历-专业
├─ lastCompanyName	string	非必须		最新工作经历-公司名
├─ offer	object	非必须		offer信息
├─ recommendId	number	非必须		订单ID
├─ orgName	null	非必须		组织名
├─ externalOrgCode	null	非必须		组织编码
├─ entryDate	string	非必须		入职日期 yyyyMMdd
├─ internshipSalary	string	非必须		实习工资
├─ formalSalary	string	非必须		工资
├─ formalSalaryType	number	非必须		工资类型：1 月薪 2 年薪3 日薪
├─ probationPeriod	number	非必须		试用期
├─ totalRecords	number	非必须		总记录数
├─ pageSize	number	非必须		条数
├─ current	number	非必须		页码
├─ totalPages	number	非必须		总页数
├─ topPageNo	number	非必须
├─ previousPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ lastPage	boolean	非必须
├─ bottomPageNo	number	非必须
├─ firstPage	boolean	非必须
issuccess	boolean	非必须

订单离职操作

基本信息

Path： /api/recommend/handle/leave.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
companyId	是		公司ID
sign	是		签名
leaveDate	否		离职日期
reason	否		离职说明
recommendId	是		订单ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		状态码成功200
message	string	非必须		信息
data	object	非必须
issuccess	boolean	非必须

面试登记相关接口

POST 获取面试登记表列表

基本信息

Path： /interview/register/list.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
companyId	是	公司id
sign	是	签名
accountId	是	账号id
current	是	页码
pageSize	是	条数
jobType	是	职位类型 1已添加职位 2未添加职位
addressId	是	工作地址id
jobId	是	职位id
startTime	是	填表日期开始时间 例如1657468800000
endTime	是	填表日期结束时间 例如1660147199999
name	是	候选人名
sysType	是	1社招 2校招

返回数据

名称	类型	是否必须	默认值	备注	其他信息
SUCCESS_STATUS	string	非必须
SUCCESS_MESSAGE	string	非必须
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object	非必须
├─ id	number	非必须		主键
├─ companyId	number	非必须		公司id
├─ recommendId	number	非必须		订单id
├─ source	number	非必须		订单来源
├─ resId	number	非必须		简历id
├─ jobId	number	非必须		职位id
├─ recommendDelFlag	number	非必须		订单是否已经被删除 0否 1是
├─ interviewDateStr	string	非必须		面试时间字符串
├─ interviewDate	number	非必须		面试时间
├─ resName	string	非必须		简历名称
├─ jobName	string	非必须		职位名称
├─ createTime	number	非必须		创建时间
├─ city	string	非必须		城市-区code
├─ addressName	string	非必须		详细地址
├─ addressId	number	非必须		地址id
├─ hrecommendId	number	非必须		h端订单ID
├─ headUrl	string	非必须		头像地址
├─ stageName	string	非必须		阶段名称
├─ stageType	number	非必须		阶段类型
├─ recruitStageId	number	非必须		阶段id
├─ recomResult	number	非必须		订单结果
├─ interviewId	number	非必须		面试id
├─ sysType	number	非必须		系统类型
├─ interviewResultDtos	object []	非必须		面试结果	item 类型: object
├─ id	number	非必须		主键
├─ contactId	number	非必须		评审人ID
├─ name	string	非必须		评审人名字
├─ status	number	非必须		0 不通过 1 通过
├─ interviewResult	number	非必须		面试评价结果 1、约复试 2、谈薪资 3、人选没到 4、淘汰 5、已取消
├─ content	string	非必须		备注内容
├─ templateAppraises	object []	非必须		模板评价信息	item 类型: object
├─ id	number	非必须		题目id
├─ type	number	非必须		题目类型：1单选 2多选 3单行文本 4多行文本 5打分题
├─ name	string	非必须		问题名称(描述)
├─ remark	string	非必须		备注
├─ requiredFlag	number	非必须		是否必填：0否 1是
├─ sysFlag	number	非必须		是否默认 0否 1是
├─ sort	number	非必须		题目顺序
├─ questionItemDtoList	object []	非必须		单行多行文本内容	item 类型: object
├─ id	number	非必须		主键ID
├─ title	string	非必须		题目
├─ sort	number	非必须		选项顺序
├─ otherFlag	number	非必须		是否其他：0否 1是
├─ checked	number	非必须		是否被选中：0否 1是
├─ otherContent	string	非必须		其它对应的内容
├─ minScore	number	非必须		起始分值
├─ maxScore	number	非必须		最大分值
├─ minTag	string	非必须		起始值标签
├─ maxTag	string	非必须		最大值标签
├─ totalFlag	number	非必须		统计总分标识-矩阵打分题
├─ questionDoFlag	number	非必须		题目是否作答
├─ totalScore	number	非必须		统计总分-矩阵打分题
├─ appraiseTemplateId	number	非必须		模板id
├─ interviewTime	number	非必须		面试时间
├─ resultFlag	boolean	非必须		是否有结果
├─ totalRecords	number	非必须
├─ pageSize	number	非必须
├─ current	number	非必须
├─ totalPages	number	非必须

面试相关接口

安排面试

基本信息

Path： /recommend/interview/arrange.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
contactId	是	479542	联系人ID
companyId	是	22	公司ID
sign	是	8abf92f6c99829d46b99237cf9b55b42	签名
companyWorkspaceId	是	22	地点ID
emailTemplateId	是		邮件模版ID
emailTitle	是		邮件标题
emailContent	是		邮件内容
interviewTime	是		面试时间
interviewType	是		面试类型
remark	是		备注
interviewLength	是	30	面试时长
videoFlag	是	1	是否开视频会议室
interviewAppraiseTemplateId	是		面试评价模版ID
recommendId	是		订单ID
accountId	是		操作人ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

根据面试记录ID获取对应的面试信息

基本信息

Path： /recommend/interview/byid/info.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
interviewId	是	479542	面试记录ID
companyId	是	22	公司ID
sign	是	8abf92f6c99829d46b99237cf9b55b42	签名
accountId	是	22	账号id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ contactId	number	非必须		联系人主键
├─ name	string	非必须		联系人姓名
├─ address	string	非必须		地址
├─ mobile	string	非必须		手机号
├─ email	string	非必须		联系人邮箱
├─ emailTemplateId	null	非必须		邮件模板id
├─ companyName	string	非必须		公司名
├─ emailTitle	null	非必须		邮件主题
├─ emailContent	null	非必须		邮箱内容
├─ cityCode	string	非必须
├─ jobName	string	非必须		职位名
├─ resName	string	非必须		人选名
├─ interviewTime	number	非必须		面试时间
├─ msgFlag	number	非必须
├─ resEmail	string	非必须		人选邮箱
├─ resPhone	string	非必须		人选手机号
├─ jobId	number	非必须		职位ID
├─ resId	number	非必须		人选ID
├─ minSalary	null	非必须		最小薪资
├─ maxSalary	null	非必须		最大薪资
├─ salaryType	null	非必须		薪资类型
├─ monthSalaryType	null	非必须		月薪制度
├─ interviewPersons	object []	非必须		面试官列表	item 类型: object
├─ id	number	必须		面试官ID
├─ loginMobile	null	必须		面试官手机号
├─ brand	null	必须		品牌
├─ name	string	必须		面试官名
├─ mobile	string	必须		手机号
├─ recommendInterviewId	number	非必须		面试记录ID
├─ visibleFlag	number	非必须
├─ source	null	非必须		来源
├─ interviewType	number	非必须		面试类型
├─ contactName	string	非必须		联系人
├─ contactPhone	string	非必须		联系人手机号
├─ companyWorkspaceId	number	非必须		工作地点ID
├─ resAppraiseTemplateId	number	非必须		人选评价模版ID
├─ resAppraiseTemplateName	string	非必须		人选评价模版名
├─ interviewAppraiseTemplateId	number	非必须		模版ID
├─ interviewAppraiseTemplateName	string	非必须		模版名
├─ feedbackFlag	number	非必须		是否反馈
├─ joinUrl	string	非必须		视频url
├─ videoFlag	number	非必须		是否视频面试
├─ interviewLength	number	非必须		面试时长
issuccess	boolean	非必须

面试日历列表

基本信息

Path： /recommend/interview/calendar.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
month	是	20220701	月份
companyId	是	22	公司ID
sign	是	b55c159ed815c6570092d27d256583ff	签名
sysType	是	1	系统 1 社招 2 校招
accountId	是	22	账号ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	必须
├─ companyId	number	必须		公司ID
├─ recommendId	number	必须		订单ID
├─ companyWorkspaceId	number	必须		地点ID
├─ source	number	必须		来源
├─ recruitStageId	number	必须		节点ID
├─ hoptLogId	number	必须
├─ interviewDate	string	必须		面试时间
├─ contactId	number	必须
├─ address	string	必须		详细地址
├─ cityCode	string	必须		城市编码
├─ cityName	string	必须		城市名
├─ accountId	number	必须		账号ID
├─ accountName	string	必须		账号名
├─ createTime	number	必须
├─ modifyTime	number	必须
├─ interviewTime	number	必须		面试时间
├─ jobId	number	必须		职位ID
├─ jobName	string	必须		职位名
├─ rotation	number	必须		时长
├─ interviewType	number	必须		面试类型
├─ resId	number	必须		简历ID
├─ resName	string	必须		人选名
├─ phone	string	必须		人选手机号
├─ contactName	null	必须		联系人名
├─ interviewResultId	null	必须
├─ cancelFlag	null	必须		是否取消
├─ cancelReason	null	必须		取消理由
├─ content	null	必须		备注
├─ recruitStageName	string	必须		阶段名
├─ dataType	null	必须
├─ interviewerName	null,string	必须		面试官名
├─ sysType	null	必须
├─ joinUrl	null	必须		面试会议室url
issuccess	boolean	非必须

面试评价列表

基本信息

Path： /recommend/interview/appraise/info.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是	22	公司ID
sign	是	b55c159ed815c6570092d27d256583ff	签名
sysType	是	1	系统 1 社招 2 校招
accountId	是	22	账号ID
type	是	1	1 面试
relationId	是		面试记录ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	非必须		题目id
├─ type	number	非必须		题目类型：1单选 2多选 3单行文本 4多行文本 5打分题
├─ name	string	非必须		问题名称(描述)
├─ remark	string	非必须		备注
├─ requiredFlag	number	非必须		是否必填：0否 1是
├─ sysFlag	number	非必须		是否默认 0否 1是
├─ totalFlag	string	非必须
├─ questionResult	string	非必须		单行多行文本内容
├─ minScore	number	非必须		起始分值
├─ maxScore	number	非必须		最大分值
├─ minTag	string	非必须		起始值标签
├─ maxTag	string	非必须		最大值标签
├─ questionDoFlag	string	非必须		题目是否作答
├─ totalScore	number	非必须		统计总分-矩阵打分题
├─ questionItemDtoList	object []	非必须			item 类型: object
├─ title	string	非必须		题目
├─ checked	string	非必须		是否选中 0 否 1 是
├─ otherContent	string	非必须		其它对应的内容
├─ answerResult	string	非必须		选项答案
issuccess	boolean	非必须

帐号相关

同步保存账户信息

基本信息

Path： /account/save.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Query

参数名称	是否必须	示例	备注
companyId	是		公司ID
sign	是		签名
name	是		帐号姓名
roleType	是		2、hr角色 3、用人经理 4、内推人 5、前台 8 管理员
mobile	是		手机号
email	是		邮箱
positionName	否		职位名称
gender	否		性别
workNo	否		工号
tenant	是		租户编码
accountId	否		帐号ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ accountId	number	非必须		帐号ID
├─ companyId	number	非必须		公司ID
├─ name	string	非必须		姓名
├─ roleType	number	非必须		角色
├─ mobile	string	非必须		手机号
├─ email	null	非必须		邮箱
├─ positionName	null	非必须		职位描述
├─ gender	null	非必须		性别 0 女 1 男
├─ workNo	null	非必须		工号
├─ tenant	null	非必须		租户编码
issuccess	boolean	非必须

帐号免登陆接口--校验通过后会自定重定向到聘聘首页

基本信息

Path： /account/auth/sso.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是		公司ID
accountId	是		帐号ID
sign	是		签名

返回数据

名称	类型	是否必须	默认值	备注	其他信息

获取帐号信息

基本信息

Path： /account/info.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
companyId	是		公司ID
accountId	是		帐号ID
sign	是		签名 生成方式看签名算法

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ accountId	number	非必须		帐号ID
├─ accountName	string	非必须		帐号名
├─ companyId	number	非必须		公司ID
├─ customerId	number	非必须		crm端客户ID
├─ companyName	string	非必须		公司名
├─ abbrName	string	非必须		昵称
├─ logoUrl	string	非必须		公司logo
├─ roleType	number	非必须		角色类型
├─ mobile	string	非必须		手机号
├─ email	null	非必须		邮箱
├─ subAccount	null	非必须		主子账号 0 主账号 1子账号
├─ status	null	非必须		状态 1 可用 2 禁用
├─ gender	null	非必须		性别 0 女 1 男
├─ tenant	null	非必须		租户代码
issuccess	boolean	非必须

测评云相关

根据ID列表获取测评记录详情（ID最多100个）

基本信息

Path： /basic/talent/detail/byrecordids.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Query

参数名称	是否必须	示例	备注
appId	是	APPID	APPID
sign	是		签名

Body

名称	类型	是否必须	默认值	备注	其他信息
recordIds	number []	非必须		记录ID 限制最多100个	item 类型: number
├─		非必须

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ id	number	非必须		记录ID
├─ companyId	number	非必须
├─ name	string	非必须		姓名
├─ jobName	string	非必须		职位
├─ mobile	string	非必须		手机号
├─ email	null	非必须		邮箱
├─ initiationTime	number	非必须		发起时间
├─ endDate	number	非必须		截止日期
├─ duration	number	非必须		测评有效期（天）
├─ reportVisible	null	非必须		是否可见
├─ status	number	非必须		状态
├─ statusName	string	非必须		状态名称
├─ evaluateUrl	string	非必须		测评链接
├─ toolType	string	非必须		类型
├─ toolTypeName	string	非必须		类型名称
issuccess	boolean	非必须

下载测评明细Excel

基本信息

Path： /basic/talent/export/down.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型
exportPage	否		1-全部页 0 非全部页 默认是非全部页
recordIds	是		exportPage 是非全部页 必需传 测评记录ID 逗号分隔 如 2344,3434
name	否		测评人姓名
mobile	否		测评人手机号
toolType	否		测评工具编码code
status	否		0-未发起, 1-待作答，2-已完成，3-已过期
startTime	否		测评发起开始时间 yyyyMMddHHmmss
endTime	否		测评发起结束时间 yyyyMMddHHmmss

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ downloadUrl	string	非必须		下载地址
issuccess	boolean	非必须

删除已过期或已完成的测评记录

基本信息

Path： /basic/talent/batch/expire/del.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型
recordIds	是		测评记录ID 逗号分隔

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须		true 成功 false 失败
issuccess	boolean	非必须

单个催促人选答题

基本信息

Path： /basic/talent/single/urge.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型
companyName	是		公司名
recordId	是		测评记录ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		状态码
message	string	非必须
data	boolean	非必须		true 成功
issuccess	boolean	非必须

发起测评接口

基本信息

Path： /basic/talent/apply.json

Method： POST

接口描述：

{
    "status": "200",
    "message": "成功",
    "data": {
        "applyFailList": [],
        "succeedList": [
            {
                "recordId": 5589,
                "mobile": "18519921163",
                "name": "lisi",
                "evaluationUrl": "http://t.pinpin.com/x8Ssj",
                "type": 31,
                "headHuntingId": null
            },
            {
                "recordId": 5590,
                "mobile": "18519921163",
                "name": "lisi",
                "evaluationUrl": "http://t.pinpin.com/x8Ssj",
                "type": 32,
                "headHuntingId": null
            }
        ]
    },
    "issuccess": true
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyName	是		公司名
companyId	否	12123	业务方公司标志 数字类型

Body

名称	类型	是否必须	默认值	备注	其他信息
applyUserList	object []	必须		测评人信息-必填	item 类型: object
├─ name	string	必须		测评人名
├─ mobile	string	必须		测评人手机号
├─ email	string	非必须		测评人邮箱
├─ jobName	string	非必须		职位
toolTypes	string []	必须		测评工具列表	item 类型: string
├─		非必须
duration	number	必须		测评有效时间（天）-不能为空
reportVisible	boolean	必须		报告是否可见-默认不可见
sendMsg	boolean	非必须		是否发送短信 true 是 false 否 默认true
sendEmail	boolean	非必须		是否发送邮件 true 是 false 否 默认true

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ applyFailList	string []	非必须			item 类型: string
├─		非必须
├─ succeedList	object []	非必须			item 类型: object
├─ recordId	number	必须		测评记录ID
├─ mobile	string	必须		手机号
├─ name	string	必须		姓名
├─ evaluationUrl	string	必须		评价链接
├─ type	number	必须		测评类型
issuccess	boolean	非必须

批量催促人选答题

基本信息

Path： /basic/talent/batch/urge.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型
companyName	是		公司名
recordIds	是		测评记录ID 逗号分隔如 123,453
allUrge	是	true/false	true 则取所有符合条件的测评订单 false 取recordIds 值。默认为false

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须

查询发起过测评关联的职位列表

基本信息

Path： /basic/talent/job/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否	12312	业务内公司标识 数字类型

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	string []	非必须		职位名列表	item 类型: string
├─		非必须		职位名
issuccess	boolean	非必须

分页查询测评发起记录

基本信息

Path： /basic/talent/evaluation/page.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务方公司标志 数字类型
name	否		测评人姓名
mobile	否		测评人手机号
jobName	否		测评人职位
toolType	否		测评工具 见basic/talent/tool/list.json
startDate	否		开始时间。时间戳
endDate	否		结束时间。时间戳
status	否		测评状态0-未发起, 1-待作答，2-已完成，3-已过期
current	是		页码
pageSize	是		条数

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ list	object []	非必须		数据	item 类型: object
├─ id	number	必须		测评记录ID
├─ companyId	number	必须		业务公司ID
├─ name	string	必须		测评人姓名
├─ jobName	string	必须		职位
├─ mobile	string	必须		手机号
├─ email	string	必须		邮箱
├─ initiationTime	number	必须		发起测评时间
├─ endDate	number	必须		截止日期
├─ duration	number	必须		测评有效期（天）
├─ reportVisible	number	必须		是否可见 仅外部对接适用
├─ status	number	必须		测评状态 0-未发起 1-待作答 2-已完成 3-已过期
├─ evaluateUrl	string	必须		测评链接
├─ simpleUrl	string	必须		简版报告链接
├─ reportUrl	string	必须		报告链接
├─ generalReportUrl	null	必须		综合报告分报告
├─ reportTime	null	必须		报告时间
├─ commitTime	null	必须		提交试卷时间
├─ answerTime	null	必须		答题时长（秒）
├─ remark	string	必须
├─ modifyTime	number	必须
├─ toolType	string	必须		测评工具类型
├─ toolTypeName	string	必须		测评工具名称
├─ fileName	string	必须		文件名称
├─ statusDesc	string	必须		测评状态描述
├─ initiationTimeStr	string	必须		测评发起时间
├─ initiationTimestamp	number	必须		测评发起时间戳
├─ totalRecords	number	非必须		总条数
├─ pageSize	number	非必须
├─ current	number	非必须
├─ totalPages	number	非必须
├─ topPageNo	number	非必须
├─ previousPageNo	number	非必须
├─ nextPageNo	number	非必须
├─ bottomPageNo	number	非必须
├─ firstPage	boolean	非必须
├─ lastPage	boolean	非必须
issuccess	boolean	非必须

根据报告ID获取报告链接

基本信息

Path： /basic/talent/report/link.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型
reportId	是		报告ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须		状态码
message	string	非必须		消息
data	string	非必须		链接url
issuccess	boolean	非必须

根据测评ID获取测评报告信息

基本信息

Path： /basic/talent/record/report.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
recordId	是		测评记录ID
companyId	否		业务公司ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ recordId	number	非必须		测评记录ID
├─ name	string	非必须		测评人名字
├─ pdfFileName	string	非必须		pdf报告名称
├─ toolTypeName	string	非必须		测评工具
├─ toolType	string	非必须		测评工具code
├─ statusDesc	string	非必须		测评状态
├─ status	number	非必须		测评状态code 测评状态0-未发起, 1-待作答，2-已完成，3-已过期
├─ reportUrl	string	非必须		测评报告链接
├─ generalReportUrl	null	非必须		综合测评报告连接
├─ reportTime	string	非必须		报告时间
├─ reportTimestamp	number	非必须		报告时间戳
issuccess	boolean	非必须

获取mbti测评结果详情

基本信息

Path： /basic/talent/mbti/report/data.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Query

参数名称	是否必须	示例	备注
AppId	是
sign	是		签名

Body

名称	类型	是否必须	默认值	备注	其他信息
recordId	number	必须		测评记录ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ examScore	object	非必须		测评得分
├─ examScoreE	number	非必须		外向得分
├─ examScoreI	number	非必须		内向得分
├─ examScoreS	number	非必须		感觉得分
├─ examScoreN	number	非必须		直觉得分
├─ examScoreT	number	非必须		思考得分
├─ examScoreF	number	非必须		情感得分
├─ examScoreJ	number	非必须		判断得分
├─ examScoreP	number	非必须		知觉得分
├─ examType	object	非必须		所属类型
├─ examResult	string	非必须		测评结果
├─ mbtiType	string []	非必须		所属类型	item 类型: string
├─		非必须
├─ personalityDesc	string	非必须		人格特点
├─ basicDesc	string	非必须		个性特点
├─ suitableIndustry	string	非必须		适合行业
├─ characterAnalyse	object	非必须		性格描述分析
├─ characterDesc	string	非必须		性格描述
├─ personalityDesc	string	非必须		性格特点
├─ weak	string	非必须		潜在弱点
├─ characterSW	object	非必须		优势劣势
├─ strength	string	非必须		性格优势
├─ weakness	string	非必须		性格劣势
├─ addSource	number	非必须
issuccess	boolean	非必须

获取可用的测评工具列表

基本信息

Path： /basic/talent/tool/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是	76451C86701C7334CB9F3F41A203EE28	应用唯一标识 由测评云管理员提供
sign	是	97ca853b1c16b11422e310b0c3d67f77	签名

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ code	string	必须		测评工具类型code
├─ name	string	必须		测评工具名称
issuccess	boolean	非必须

获取可用的测评工具详情列表

基本信息

Path： /basic/talent/tool/detail/list.json

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		唯一应用ID
sign	是		签名，见签名算法

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object []	非必须			item 类型: object
├─ evaluationToolType	string	必须		测评资源类型code
├─ toolName	string	必须		测评工具名称
├─ toolMark	string	必须		测评工具分类标记 1、职业性格测评（MBTI 和DISC）；2、通用社会招聘素质测评（通用社会招聘素质测评）；3、职位经理人素质测评（职位经理人素质测评）；4、核心岗位胜任素质测评（销售/财务/行政等）等
├─ toolRemark	string	必须		测评说明
├─ toolValues	string	必须		测评价值
├─ usageScene	string	必须		应用场景
├─ usagePerson	string	必须		适用人群
├─ referenceTime	number	必须		参考用时(分)
├─ totalNumber	number	必须		题目总量
├─ evaluateIndicator	string	必须		测试指标
├─ evaluateIndicatorNumber	string	必须		指标数据量
├─ evaluateFacetNumber	string	必须		构面数量
├─ evaluateMode	string	必须		测评方式
├─ evaluateChart	string	必须		指标图链接
├─ reportDemoUrl	string	必须		示例报告链接
├─ applyType	number	必须		发起方式 0-内部 1-外部
├─ remark	string	必须
├─ toolType	string	必须		测评资源类型
issuccess	boolean	非必须

触发生成综合报告

基本信息

Path： /basic/talent/general/report.json

Method： GET

接口描述：

说明：该接口仅仅用于触发生成综合报告，由于生成综合报告需要一定的时长，且不确定，所以可以根据返回的reportId 调用相关接口（/basic/talent/report/link.json） 获取具体报告链接，downloadUrl 返回值时可以直接使用，如果没有返回值请根据返回的reportId 调用相关接口 （/basic/talent/report/link.json）

请求参数

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型
companyName	是		公司名称
recordIds	是		测评记录ID 逗号分隔

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	object	非必须
├─ fileName	string	非必须		文件名
├─ downloadUrl	string	非必须		下载url
├─ fileType	number	非必须		文件类型，0 PDF，1 ZIP
├─ reportId	number	非必须		报告ID
issuccess	boolean	非必须

重新发起测评

基本信息

Path： /basic/talent/apply/again.json

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Query

参数名称	是否必须	示例	备注
appId	是		应用唯一标识 由测评云管理员提供
sign	是		签名
companyId	否		业务内公司标识 数字类型

Body

名称	类型	是否必须	默认值	备注	其他信息
recordIds	number []	必须		测评记录ID列表	item 类型: number
├─		非必须		测评记录ID
companyName	string	必须		公司名

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	string	非必须
message	string	非必须
data	boolean	非必须
issuccess	boolean	非必须