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   阅读数 28

获取招聘官网上的职位列表

HTTP请求

GET https://api.mokahr.com/api-platform/v1/jobs/{orgId}

请求URL参数

字段

必填

类型

描述

orgId

string

每个企业客户对应的唯一id

请求query参数

字段

必填

类型

描述

mode

string

招聘模式
可选值:
social:社招
campus:校招

keyword

string

搜索关键字

limit

string

分页用的每页条数,默认30

offset

string

分页用的偏移量,所示索引从0开始

locationIds

array

通过地址列表接口返回的地址id,比如[1,2,3]
详细参数见职位地址

zhinengId

number

通过职能列表接口返回的地址id
详细参数见职位职能

siteId

number

官网id

commitment

number

职位性质
可选值:
1:全职
2:兼职
3:实习
4:其他

updatedFromAt

string

职位按更新时间筛选的起始时间,比如2020-06-01

updatedEndAt

string

职位按更新时间筛选的截止时间,比如2020-07-01

status

string

职位状态
可选值:
open:开启
closed:关闭
pause:暂停

返回body的JSON数据如下:

字段

类型

描述

total

integer

职位总数量

jobs[]

array

职位列表

jobs[].id

string

职位id

jobs[].title

string

职位名称

jobs[].status

string

职位状态
可选值:
open:开启
closed:关闭
pause:暂停

jobs[].description

string

职位描述

jobs[].mjCode

string

职位编号

jobs[].minSalary

integer

最低薪资,单位:千(K)

jobs[].maxSalary

integer

最高薪资,单位:千(K)

jobs[].minExperience

integer

最低工作经验

jobs[].maxExperience

integer

最高工作经验

jobs[].number

integer

招聘人数

jobs[].commitment

string

职位性质
可选值:
全职
兼职
实习
其他

jobs[].education

string

学历要求

jobs[].closedAt

string

职位关闭时间。日期格式为:ISO8601

jobs[].openedAt

string

开始招聘时间。日期格式为:ISO8601

jobs[].updatedAt

string

职位更新时间。日期格式为:ISO8601

jobs[].prior

integer

是否优先招聘,1为优先招聘

jobs[].hireMode

integer

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

jobs[].finishedAt

string

职位目标完成时间

jobs[].isRecommendation

boolean

是否为内推职位

jobs[].department

object

职位所在部门信息

jobs[].department.id

integer

部门id

jobs[].department.name

string

部门名称

jobs[].locations

array

职位工作地

jobs[].locations[].id

integer

地址id

jobs[].locations[].province

string

jobs[].locations[].city

string

jobs[].locations[].area

string

jobs[].locations[].country

string

国家

jobs[].locations[].address

string

详细地址

jobs[].zhineng

object

职位职能信息

jobs[].zhineng.id

integer

职能id

jobs[].zhineng.name

string

职能名称

jobs[].customFields

array

职位自定义字段列表

jobs[].customFields[].id

integer

自定义字段id

jobs[].customFields[].name

string

自定义字段名称

jobs[].customFields[].type

string

自定义字段类型
可选值:
string_info
bool_info

jobs[].customFields[].value

string

自定义字段的值

jobs[].jobManager

object

职位负责人 (此项字段默认不返回,若要返回请联系与您企业对接的客户成功经理协助打开官网职位接口负责人同步开关)

jobs[].jobManager.name

string

职位负责人姓名

jobs[].jobManager.email

string

职位负责人邮箱

jobs[].jobManager.phone

string

职位负责人手机号

jobs[].jobManager.employee_id

string

职位负责人工号

jobs[].jobHrAssistant

object[]

职位协助人 (此项字段默认不返回,若要返回请联系与您企业对接的客户成功经理协助打开官网职位接口负责人同步开关)

jobs[].jobHrAssistant[].name

string

职位协助人姓名

jobs[].jobHrAssistant[].email

string

职位协助人邮箱

jobs[].jobHrAssistant[].phone

string

职位协助人手机号

jobs[].jobHrAssistant[].employee_id

string

职位协助人工号

jobs[].jobHiringManager

object[]

用人经理 (此项字段默认不返回,若要返回请联系与您企业对接的客户成功经理协助打开官网职位接口负责人同步开关)

jobs[].jobHiringManager[].name

string

用人经理姓名

jobs[].jobHiringManager[].email

string

用人经理邮箱

jobs[].jobHiringManager[].phone

string

用人经理手机号

jobs[].jobHiringManager[].employee_id

string

用人经理工号

jobs[].jobInterviewer

object[]

面试官 (此项字段默认不返回,若要返回请联系与您企业对接的客户成功经理协助打开官网职位接口负责人同步开关)

jobs[].jobInterviewer[].name

string

面试官姓名

jobs[].jobInterviewer[].email

string

面试官邮箱

jobs[].jobInterviewer[].phone

string

面试官手机号

jobs[].jobInterviewer[].employee_id

string

面试官工号

Q&A

1、关于已关闭招聘的职位是否显示:职位在关闭的时候如果没勾选取消在官网显示,则还会官网显示,并且其中closedAt是关闭时间。
image.png 2、是否支持删除职位或者显示删除的职位:不支持,删除了就彻底没了,如果这个职位下有招聘过程中的候选人数据,则系统内无法删除。

请求样例

$ curl https://api.mokahr.com/api-platform/v1/jobs/moka\?mode\=social \
   -X GET
1
2
plaintext

返回样例

{ "total": 10000, "jobs": [ { "id": "1234", "title": "网页设计师", "status": "open", "description": "<div><b>我们是谁</b><div>", "minSalary": 1000, "maxSalary": 9000, "minExperience": 3, "maxExperience": 5, "number": 10, "commitment": "全职", "education": "本科", "closedAt": "2017-10-01T22:00:00.000Z", "openedAt": "2017-09-01T21:00:00.000Z", "prior": 1, "hireMode": 1, "mjCode": "MJ001", "finishedAt": "2019-08-23T16:00:00.000Z", "department": { "id": 1, "name": "技术部" }, "locations": [ { "id": 1, "province": "广东", "city": "深圳市", "area": "福田区", "country": "中国", "address": "车公庙泰然大厦C座22楼" } ], "zhineng": { "id": 1, "name": "技术类" }, "customFields": [ { "id": 1, "name": "薪资范围", "value": "100-200", "type": "string_info" } ] } ] }
1
plaintext
未能解决您的问题?请联系
本篇目录

HTTP请求

请求URL参数

请求query参数

返回body的JSON数据如下:

Q&A

请求样例

返回样例