获取招聘官网上的职位列表
HTTP请求
GET https://api.mokahr.com/api-platform/v1/jobs/{orgId}
请求URL参数
字段 | 必填 | 类型 | 描述 |
---|---|---|---|
orgId | 是 | string | 每个企业客户对应的唯一id |
请求query参数
字段 | 必填 | 类型 | 描述 |
---|---|---|---|
mode | 是 | string | 招聘模式 |
keyword | 否 | string | 搜索关键字 |
limit | 否 | string | 分页用的每页条数,默认30 |
offset | 否 | string | 分页用的偏移量,所示索引从0开始 |
locationIds | 否 | array | 通过地址列表接口返回的地址id,比如[1,2,3] |
zhinengId | 否 | number | 通过职能列表接口返回的地址id |
siteId | 否 | number | 官网id |
commitment | 否 | number | 职位性质 |
updatedFromAt | 否 | string | 职位按更新时间筛选的起始时间,比如2020-06-01 |
updatedEndAt | 否 | string | 职位按更新时间筛选的截止时间,比如2020-07-01 |
status | 否 | string | 职位状态 |
返回body的JSON数据如下:
字段 | 类型 | 描述 |
---|---|---|
total | integer | 职位总数量 |
jobs[] | array | 职位列表 |
jobs[].id | string | 职位id |
jobs[].title | string | 职位名称 |
jobs[].status | string | 职位状态 |
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 | 是否优先招聘, |
jobs[].hireMode | integer | 招聘模式 |
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 | 自定义字段类型 |
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
2
返回样例
{ "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" } ] } ] }