所有文章

申请一个职位

最后更新于 2024/04/03 阅读数 18

返回新申请的信息这个API支持两种请求格式，分别是multipart/form-data方式和json方式。如果你需要上传简历或者附件文件，就必须使用multipart/form-data方式。使用multipart/form-data方式上传的简历文件会经过我们的简历解析服务做处理。此API需要验证身份信息，验证方式请参考请求验证/Auth部分。注意：该模块字段是否必填取决于系统内字段属性设置

HTTP请求

POST https://api.mokahr.com/api-platform/v1/jobs/{orgId}/{jobId}/apply

请求URL参数

字段	必填	类型	描述
orgId	是	string	每个公司客户对应的唯一id
jobId	是	string	职位id

请求query参数

字段	必填	类型	描述
isRecommendation	否	integer	是否是内推申请可选值： `1`：是内推申请 `不传参`：非内推申请
isCheckProtect	否	integer	是否校验保护期可选值： `1`：且isRecommendation=1 校验保护期 `不传参`：不校验保护期
recommendationType	否	integer	内推官网拆分后需要配合使用可选值：`1`：社招内部推荐 `2`：校招内部推荐
siteId	否	integer	是否是指定官网渠道，如果不传是系统默认官网，如果传入了isRecommendation，则此参数无效
acquisitionMode	否	integer	申请方式可选值： `0`：未知 `2`：后台导入 `5`：人才推荐 `8`：主动推荐 `9`：主动申请

请求body(json方式)

字段	必填	类型	描述
basicInfo	是	string	基本信息，至少要有一个属性
basicInfo.name	否	string	候选人姓名
basicInfo.age	否	integer	候选人年龄
basicInfo.gender	否	string	候选人性别可选值 `男` `女`
basicInfo.email	否	string	候选人邮箱地址
basicInfo.phone	否	string	候选人电话号码
basicInfo.lastCompany	否	string	最近公司
basicInfo.lastSpeciality	否	string	最近毕业专业
basicInfo.academicDegree	否	string	最高学历
basicInfo.political	否	string	政治面貌
educationInfo	否	array	教育经历
educationInfo[].school	否	string	学校名称
educationInfo[].startDate	否	string	开始时间
educationInfo[].endDate	否	string	结束时间
educationInfo[].speciality	否	string	专业
educationInfo[].academicDegree	否	string	学历
experienceInfo	否	array	工作经验
experienceInfo[].company	否	string	公司名称
experienceInfo[].startDate	否	string	开始时间
experienceInfo[].endDate	否	string	结束时间
experienceInfo[].title	否	string	工作职位
experienceInfo[].summary	否	string	工作职责
languageInfo	否	array	语言能力
languageInfo[].language	否	string	语言类型
languageInfo[].level	否	string	掌握程度
languageInfo[].listenAndSpeak	否	string	听说能力
languageInfo[].readAndWrite	否	string	读写能力
projectInfo	否	array	项目经验
projectInfo[].projectName	否	string	项目名称
projectInfo[].startDate	否	string	开始时间
projectInfo[].endDate	否	string	结束时间
projectInfo[].title	否	string	项目中担任的> 职责
projectInfo[].projectDescription	否	string	项目描述
projectInfo[].responsibilities	否	string	项目中的职责
practiceInfo	否	array	实习经验
practiceInfo[].company	否	string	公司名称
practiceInfo[].title	否	string	职位名称
practiceInfo[].startDate	否	string	开始时间
practiceInfo[].endDate	否	string	结束时间
practiceInfo[].summary	否	string	工作职责
jobIntention	否	object	求职意向
jobIntention.aimSalary	否	string	期望薪资，单位：千（K)
jobIntention.forwardLocation	否	string	期望城市
selfDescription	否	object	自我描述
selfDescription.personal	否	object	自我描述，简介
customFields[].id	否	integer	自定义字段id
customFields[].value	否	string	自定义字段值
customFields[].index	否	number	如果当前模块数据是一个数组且含有自定义字段，则该值必填且与数组下标一致(备注：支持自定义模块数据)
recommender.name	否	string	推荐人姓名
recommender.email	否	string	推荐人邮箱
recommender.phone	否	string	推荐人电话
recommender.employeeId	否	string	推荐人工号

请求body(multipart/form-data方式)

字段	必填	类型	描述
basicInfo	是	string	json格式的字符串，字段同json请求方式的basicInfo
educationInfo	否	string	json格式的字符串，字段同json请求方式的educationInfo
experienceInfo	否	string	json格式的字符串，字段同json请求方式的experienceInfo
projectInfo	否	string	json格式的字符串，字段同json请求方式的projectInfo
practiceInfo	否	string	json格式的字符串，字段同json请求方式的practiceInfo
languageInfo	否	string	json格式的字符串，字段同json请求方式的languageInfo
jobIntention	否	string	json格式的字符串，字段同json请求方式的jobIntention
selfDescription	否	string	json格式的字符串，字段同json请求方式的selfDescription
recommender	否	string	json格式的字符串，字段同json请求方式的recommender
customFields	否	string	json格式的字符串，字段同json请求方式的customFields
resume	否	file	简历文件
attachments	否	file	附件文件，最多支持10个

返回(部分字段)

字段	类型	描述
id	integer	申请id
candidateId	integer	候选人id
orgId	integer	租户id
stageId	integer	阶段id
name	name	候选人姓名
age	age	候选人年龄
candidateId	long	候选人ID
gender	string	候选人性别
countryCallingCode	string	国家呼叫代码
skill	string	技能
recommendReason	string	推荐原因
educationInfo	array	教育经历
educationInfo[].school	string	学校名称
educationInfo[].startDate	string	开始时间
educationInfo[].endDate	string	结束时间
educationInfo[].speciality	string	学习专业
educationInfo[].academicDegree	string	学历
experienceInfo	array	工作经验
experienceInfo[].company	string	公司名称
experienceInfo[].startDate	string	开始时间
experienceInfo[].endDate	string	结束时间
experienceInfo[].title	string	工作职位
experienceInfo[].summary	string	工作职责
projectInfo	array	项目经验
projectInfo[].projectName	string	项目名称
projectInfo[].startDate	string	开始时间
projectInfo[].endDate	string	结束时间
projectInfo[].title	string	项目中担任的> 职责
projectInfo[].projectDescription	string	项目功能描述
projectInfo[].responsibilities	string	项目中的职责
practiceInfo	array	实习经验

请求样例(json方式)

$ curl https://api.mokahr.com/api-platform/v1/jobs/moka/1234/apply \
  -u 'your-api-key:' \
  -X POST \
  -H 'Content-Type: application/json' \
  -d ' { "basicInfo": { "name": "张三", "age": 22, "email": "zhangsan@mokahr.com", "gender": "男", "phone": "18612345678", "lastCompany": "阿里巴巴", "lastSpeciality": "计算机", "academicDegree": "本科" }, "educationInfo": [ { "school": "北京大学", "startDate": "2014-09", "endDate": "2017-06", "speciality": "软件工程", "academicDegree": "本科" } ], "experienceInfo": [ { "company": "百度", "startDate": "2014-09", "endDate": "2017-06", "title": "初级工程师", "summary": "负责产品功能实现" } ], "languageInfo": [ { "language": "213", "level": "一般", "listenAndSpeak": "良好", "readAndWrite": "熟练" } ], "projectInfo": [ { "projectName": "项目1", "startDate": "2017-01", "endDate": "2017-11", "projectDescription": "项目功能描述", "title": "后端工程师", "responsibilities": "项目职责" } ], "practiceInfo": [ { "company": "腾讯", "title": "实习工程师", "startDate": "2017-01", "endDate": "2017-11", "summary": "负责简单的功能实现" } ], "jobIntention": { "aimSalary": "7000-13000元/月", "forwardLocation": "北京" }, "selfDescription": { "personal": "人经历丰富,在校担任过部长,主持人以及新生教官。" }, "customFields": [ { "id": 1, "value": "aaa" "index": 0, }, { "id": 2, "value": "bbb" } ], "recommender": { "email": "zhangsan@mokahr.com", "name": "张三", "phone": "18612345678", "employeeId": "1" } }'

1
2
3
4
5

plaintext

请求样例(multipart/form-data方式)

$ curl https://api.mokahr.com/api-platform/v1/jobs/moka/1234/apply \
   -u 'your-api-key:' \
   -X POST \
   -H 'Content-Type: multipart/form-data' \
   -F 'basicInfo={"name": "张三", "age": 20, "gender": "男", "phone": "18612345678"}' \
   -F 'educationInfo=[{"school": "北京大学", "startDate": "2014-01", "endDate": "2017-01", "speciality": "软件工程"}]' \
   -F 'experienceInfo=[{"company": "百度", "startDate": "2017-01", "endDate": "2017-01", "title": "工程师"}]' \
   -F 'projectInfo=[{"projectName": "项目1", "startDate":"2017-01","endDate":"2017-11","title":"工程师"}]' \
   -F 'practiceInfo=[{"company":"腾讯", "title":"实习工程师", "startDate":"2017-01", "endDate":"2017-11"}]' \
   -F 'jobIntention={"aimSalary": "7000-13000/月", forwardLocation: "北京"}' \
   -F 'selfDescription={personal: "人经历丰富,在校担任过部长,主持人以及新生教官。"}' \
   -F 'customFields=[{"id": "1", "value": "aaa"}, {"id": "2", "value": "bbb"}]' \
   -F 'recommender={"email": "zhangsan@mokahr.com","name": "张三","phone":"18612345678","employeeId":"1"}' \
   -F 'resume=@/path/to/resume/张三.pdf' \
   -F 'attachments=@/path/to/attachments/attach1.txt' \
   -F 'attachments=@/path/to/attachments/attach2.txt'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

plaintext

返回样例(部分字段)

{ "id": 1, "name": "张三", "age": 20, "gender": "男", "educationInfo": [ { "school": "北京大学", "startDate": "2014-09", "endDate": "2017-06", "speciality": "软件工程", "academicDegree": "本科" } ], "experienceInfo": [ { "company": "百度", "startDate": "2014-09", "endDate": "2017-06", "title": "初级工程师", "summary": "负责产品功能实现" } ], "projectInfo": [ { "projectName": "项目1", "startDate": "2017-01", "endDate": "2017-11", "projectDescription": "项目功能描述", "title": "后端工程师", "responsibilities": "项目职责" } ] }

plaintext