通过接口直接在Moka系统中创建职位;创建职位时间即为开始招聘时间
HTTP请求
POST https://api.mokahr.com/api-platform/v1/jobs?currentHireMode=1
请求query参数
字段 | 类型 | 描述 |
---|---|---|
currentHireMode | integer | 招聘模式 |
请求body参数操作人编号
字段 | 是否必填 | 类型 | 描述 |
---|---|---|---|
title | 是 | string | 职位名称 |
status | 否 | string | 职位状态 |
description | 否 | string | 职位描述 |
commitment | 是 | string | 职位性质 |
departmentCode | 否 | string | 所属部门code |
number | 否 | integer | 招聘人数 |
minSalary | 否 | integer | 最低薪资,单位默认K |
maxSalary | 否 | integer | 最高薪资,单位默认K |
experience | 否 | string | 工作经验 |
education | 否 | string | 最低教育程度, 可选值: |
jobPriorityId | 否 | integer | 职位优先级ID |
locationId | 否 | integer | 工作地点ID |
locationIds | 否 | array | 多个工作地点ID,locationIds 和 locationId 同时存在时,优先使用 locationIds |
managerEmail | 否 | string | 负责人邮箱 |
managerNumber | 否 | string | 负责人number字段, 该值存在会忽略managerEmail字段 (managerNumber为-1时会删除负责人) |
hrAssistantEmails | 否 | Array<string> | 职位协助人邮箱 |
hrAssistantNumbers | 否 | Array<string> | 职位协助人number字段, 该值存在会忽略hrAssistantEmails字段 (hrAssistantNumbers为空数组[]时清空协助人) |
hiringManagerEmails | 否 | Array<string> | 用人经理邮箱 |
hiringManagerNumbers | 否 | Array<string> | 用人经理number字段, 该值存在会忽略hiringManagerEmails字段(hiringManagerNumbers为空数组[]时清空用人经理) |
interviewerEmails | 否 | Array<string> | 面试官邮箱 |
interviewerNumbers | 否 | Array<string> | 面试官number字段, 该值存在会忽略interviewerEmails字段(interviewerNumbers为空数组[]时清空面试官) |
jobRankIds | 否 | Array<integer> | 职位级别ID列表 |
zhinengId | 否 | integer | 职能ID |
customData | 否 | Object | 自定义数据,键值对形式,key为自定义字段id,value为自定义字段值。 |
pipelineId | 否 | integer | 招聘流程 |
headcountIds | 否 | Array<integer> | 关联HC列表 |
finishedAt | 否 | string | 招聘截止时间, 格式遵从ISO8601标准 |
siteIds | 否 | array | 官网ids |
storeIds | 否 | array | 门店id数组.如果开启了部门和门店同步,传了部门信息会优先使用部门对应的门店信息 |
jobTemplateId | 否 | number | 自定义招聘查询id |
isVirtual | 否 | boolean | 是否创建为虚拟职位,true:创建为虚拟职位,默认是实体职位 |
jobIdsForVirtualJobList | 否 | string | 虚拟职位需要关联的实体职位id |
applyForms | 否 | array | 申请表 |
applyForms[].applyFormId | 是 | number | 申请表id |
applyForms[].type | 是 | string | 申请表类型:NORMAL_PORTAL:普通官网,RECOMMENDATION_PORTAL:内推官昂 |
applyForms[].device | 是 | string | 申请表适用浏览器类型:pc或者mobild |
roundFeedbacks | 否 | array | 面试评价表 |
roundFeedbacks[].roundId | 是 | number | 面试轮次id |
roundFeedbacks[].feedbackId | 是 | string | 面试评价表id |
subscribersEmails | 否 | string[] | 简历自动推荐人邮箱。支持面试官、用人经理及以上角色。["lisi@mokahr.com"] |
subscribersNumbers | 否 | string[] | 简历自动推荐人工号。支持面试官、用人经理及以上角色。[ "1234", "2345" ] |
返回
返回body的JSON数据如下:
字段 | 类型 | 描述 |
---|---|---|
jobId | string | 职位ID,moka系统内置。 |
mjCode | string | 职位编号,发布到外部系统保证唯一性。 |
subscribersEmails | string[] | 简历自动推荐人邮箱。支持面试官、用人经理及以上角色。["lisi@mokahr.com"] |
subscribersNumbers | string[] | 简历自动推荐人工号。支持面试官、用人经理及以上角色。[ "1234", "2345" ] |
请求样例
$ curl -X POST \
'https://api.mokahr.com/api-platform/v1/jobs?currentHireMode=1' \
-u 'your-api-key:' \
-H 'Content-Type: application/json' \
-d '{ "title": "API测试", "status": "open", "commitment": "测试", "departmentCode": "1111", "minSalary": 20, "maxSalary": 50, "education": "本科", "jobPriorityId": 13, "managerEmail": "limeng@mokahr.com", "hrAssistantEmails": [ "zhangsan@mokahr.com" ], "hiringManagerEmails": [ "lisi@mokahr.com" ], "interviewerEmails": [ "wangwu@mokahr.com" ], "interviewerNumbers": [ "1234", "2345" ], "jobRankIds": [113, 114], "customData": { "2": "北京", "5": "50" }, "pipelineId": 12, "headcountIds": [1,2,3], "finishedAt": "2020-04-15 00:00:00", "siteIds":[29189,29190], "storeIds":[1234,4567] }'
2
3
4
5
返回样例
{
"success": true,
"data": {
"jobId": "d7556714-6de1-4a14-82d8-2a8fc1ac7624",
"mjCode": "MJ001789"
}
}
2
3
4
5
6
7