同步信息内包含组织架构、职位id信息需要到相关接口单独获取
HTTP请求
POST https://api.mokahr.com/api-platform/v1/headcount
请求URL参数
字段 | 类型 | 描述 |
---|---|---|
currentHireMode | integer | 招聘模式 |
请求body
字段 | 是否必填 | 类型 | 描述 |
---|---|---|---|
number | 是 | string | 招聘需求编号,编号全局唯一,且不可修改 |
jobName | 是 | string | 招聘需求名称 |
type | 否 | string | |
needNumber | 是 | integer | 需求人数 |
departmentCode | 否 | string | 部门code,组织架构同步接口传的department_code |
commitment | 否 | string | |
ownerEmail | 否 | string | 汇报对象邮箱 |
ownerEmployeeId | 否 | string | 汇报对象工号 |
managerEmails | 否 | array | 负责人邮箱:需要有权限的人员邮箱,如hr或超管 |
managerEmployeeIds | 否 | array | 负责人工号:需要有权限的人员工号,如hr或超管 |
description | 否 | string | 需求描述,html字符串: |
status | 否 | string | |
creatorEmail | 否 | String | 招聘需求创建者email,只在创建时可添加,编辑时无法修改,系统内不显示 |
startDate | 否 | string | 招聘需求开始时间。日期格式为:ISO8601 |
completeDate | 否 | string | 目标完成时间。日期格式为:ISO8601 |
connectedJobIds | 否 | array | 关联职位的id |
customData | 否 | object | 自定义字段,键值对形式,key为自定义字段id,value为自定义字段值。 |
locationId | 否 | integer | 地点id |
jobPriorityId | 否 | integer | 职位优先级id |
jobRankIds | 否 | array | 职位级别id |
minSalary | 否 | integer | 最低薪资,单位:千(K) |
maxSalary | 否 | integer | 最高薪资,单位:千(K) |
education | 否 | string | 学历要求 |
返回
返回body的JSON数据如下:
字段 | 类型 | 描述 |
---|---|---|
id | integer | hc的id |
number | string | hc编号 |
jobName | string | hc名称 |
type | string | 需求类型 |
needNumber | integer | 需求人数 |
departmentId | integer | 部门id |
commitment | string | 职位属性 |
ownerId | integer | 汇报对象id |
ownerEmail | integer | 汇报对象Email |
ownerEmployeeId | integer | 汇报对象工号 |
managerIds | array | 负责人id数组 |
managerEmails | array | 负责人邮箱数组 |
managerEmployeeIds | array | 负责人工号数组 |
description | string | 需求描述 |
status | string | 进行状态 |
creatorId | integer | hc创建者id |
creatorEmail | String | hc创建者Email |
hireMode | integer | 招聘模式 |
orgId | string | 公司id |
createAt | string | 创建时间。日期格式为:ISO8601 |
updateAt | string | 更新时间。日期格式为:ISO8601 |
startDate | string | 开始时间。日期格式为:ISO8601 |
completeDate | string | 结束时间。日期格式为:ISO8601 |
connectedJobIds | array | 关联职位的id |
connectedJobs | array | 关联职位的详情 |
usedNumber | integer | 已使用人数 |
remainNumber | integer | 剩余人数 |
customData | object | 自定义字段 |
departmentCode | string | 部门同步时使用的code |
addressInfo | array | 地点信息 |
jobPriority | array | 职位优先级信息 |
jobRanks | array | 职位级别 |
minSalary | integer | 最低薪资,单位:千(K) |
maxSalary | integer | 最高薪资,单位:千(K) |
education | string | 学历要求 |
请求样例
$ curl https://api.mokahr.com/api-platform/v1/headcount/\?currentHireMode\=1 \
-u 'your-api-key:' \
-X POST \
-H 'Content-Type: application/json' \
-d ' { "number": "hc_automan", "jobName": "hcName", "needNumber": 1, "startDate": "2017-10-12T00:00:00.000Z", "education": "本科", "departmentCode": "8", "maxSalary": 2, "minSalary": 1, "jobPriorityId": 1, "locationId": 1, "jobRankIds": [1,3], "customData": { "1": "test", "2": 123 } } '
2
3
4
5
返回样例
{ "headcount": { "id": 1, "number": "hc-automan", "jobName": "hcname", "type": "planned", "needNumber": 10, "departmentId": 1, "commitment": "fulltime", "ownerId": 1, "managerIds": [2], "description": null, "status": "unstart", "creatorId": 7, "hireMode": 1, "orgId": "livingsimple", "createdAt": "2018-01-09T10:37:32.000Z", "updatedAt": "2018-01-09T10:37:32.000Z", "startDate": "2017-10-12", "completeDate": null, "connectedJobIds": [], "connectedJobs": [], "usedNumber": 0, "remainNumber": 5, "ownerEmail": "hr@test.moka", "managerEmails": ["hr@trymoka.com"], "managerEmployeeIds": ["0018"], "departmentCode": "7", "addressInfo": [ { "id": 1, "country": "中国", "province": "北京市", "area": "海淀区", "address": "北京市海淀区海淀西大街" } ], "jobPriority": [ { "id": 14, "name": "123", "isBuiltin": 0 } ], "jobRanks": [ { "id": 1, "name": "新人", "type": "p5", "level": 1, "hcId": 8 }, { "id": 3, "name": "总裁", "type": null, "level": 3, "hcId": 8 } ] } }