ATS用户中心
所有文章
系统应用
升级公告
常见问题
公开课
校招专栏
内推和门店
数据平台
亮点功能
热门活动
基础操作视频
API文档
时间字段格式说明(Date)
API开发指南(Guide)
主动推送说明(Webhooks)
公共API
招聘官网API
企业信息API
门店API
组织架构API
职责API
用户API
候选人API
人才库API
职位API
面试API
Offer API
入职API
内推账户API
猎头API
BI报表API
district code
错误码
新建 招聘需求
最后更新于 2024/04/03   阅读数 277

同步信息内包含组织架构、职位id信息需要到相关接口单独获取

HTTP请求

POST https://api.mokahr.com/api-platform/v1/headcount

请求URL参数

字段

类型

描述

currentHireMode

integer

招聘模式
可选值:
1:社招
2:校招

请求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

招聘模式
可选值:
1:社招
2:校招

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 } } '
1
2
3
4
5
plaintext

返回样例

{ "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 } ] } }
1
plaintext
未能解决您的问题?请联系
本篇目录

HTTP请求

请求URL参数

请求body

返回

请求样例

返回样例