仟寻开放API平台文档

请求地址

Environment	URL
正式环境	https://openapi.moseeker.com
测试环境	https://openapi-t.dqprism.com

版本

版本	更新时间
v1.0.0	2019-10-21
v1.1.0	2020-04-02
v1.2.0	2020-04-15
v1.3.0	2020-05-14
v1.4.0	2021-12-27
v1.4.1	2022-01-17
v1.4.2	2022-08-10
v1.5.1	2026-08-11

总览

接口格式

接口返回值均为 JSON 格式, 包含三个字段: "code", "data", "message"

Field	Type	Description
code	int	状态码(status code), 为 0 时表示返回值正常, 其他任何值时均表示异常
message	string	提示信息
data	dict	返回的数据。详情见下面具体接口. 当一个接口仅需状态码确认时, data 可以为空

API授权

通过token的方式提供API授权，联系仟寻平台，获取相关的app_key，app_secret
根据仟寻提供的 app_key 和 app_secret 生成token令牌，访问其他 api 时需要携带令牌.

Token

Method：POST
Host：https://openapi.moseeker.com/v1
Path：/authorizations/token

Body Parameters

Key	Required	Type	Description
app_key	Yes	string	公司唯一标识
app_secret	Yes	string	秘钥

Response data

Key	Describe
token	令牌
expire	有效时间(小时)

{
    "app_key":"*****",
    "app_secret":"*****"
}

{
    "code": 0,
    "message": "",
    "data": {
        "token": "*****",
        "expire": 24
    }
}

职位

获取职位

分页获取本公司所有职位.

Get Positions

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/positions

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Query Parameters

Key	Required	Type	Description
page_num	No	integer	页码
page_size	No	integer	数量

Response data

Key	Describe
id	职位id
job_number	第三方职位id
title	职位标题
team	所在部门
cities	城市
publish_date	发布时间
stop_date	截止时间
accountability	职位描述
experience	工作经验(年)
experience_above	及以上
requirement	职位要求
language	外语要求
update_time	更新时间
business_group	事业群
employment_type	工作性质
hr_email	HR联系人邮箱
degree	学历（ 0 无, 1 大专, 2 本科, 3 硕士, 4 MBA, 5 博士, 6 中专, 7 高中 ,8 博士后 , 9 初中）
degree_above	及以上
features	职位特色
email_notice	申请后是否给HR发邮件
candidate_source	招聘类型
occupation	职位职能
is_recom	需要推荐
industry	所属行业
district	区
count	招聘人数
salary_top	薪资上限(k)
salary_bottom	薪资下限(k)
management_experience	是否要求管理经验
gender	性别
publisher	HR id
publisher_name	HR姓名
work_address	工作地址
is_hiring	是否急招
underlings	下属人数
language_required	是否要求语言
target_industry	期望人选所在行业
is_referral	是否内推
ext	职位扩展字段
addresses	LBS
top	置顶标签。true表示置顶，false表示未置顶
coordinator_id	招聘协助HR id
coordinator_name	招聘协作HR 姓名
custom_fields	职位自定义字段信息

{
    "code": 0,
    "message": "",
    "data": {
        "total": 44770,
        "page": 1,
        "data": [
            {
                "id": 19551566,
                "job_number": "JOB202003313",
                "title": "测试职位1",
                "team": {
                    "id": 188365547,
                    "name": "万达集团/商管集团/酒店管理公司"
                },
                "publish_date": "2020-03-31 18:01:46",
                "stop_date": null,
                "accountability": null,
                "experience": "3",
                "requirement": "职位要求",
                "language": "英语",
                "update_time": "2020-03-31 19:21:51",
                "business_group": "",
                "employment_type": 0,
                "hr_email": null,
                "degree": 0,
                "top":false,
                "coordinator_name": "协助HR姓名",
                "coordinator_id":"1000211",
                "features": [
                    {
                        "id": 119,
                        "company_id": 39978,
                        "name": "班车",
                        "create_time": "2018-03-06 21:04:10",
                        "update_time": "2019-10-14 17:32:11",
                        "status": "有效"
                    },
                    {
                        "id": 145,
                        "company_id": 39978,
                        "name": "加班补助",
                        "create_time": "2018-03-06 21:04:12",
                        "update_time": "2019-10-28 15:59:21",
                        "status": "有效"
                    }
                ],
                "email_notice": 0,
                "candidate_source": 0,
                "occupation": "",
                "is_recom": 1,
                "industry": "",
                "district": "",
                "count": 1,
                "salary_top": 100,
                "salary_bottom": 10,
                "experience_above": 0,
                "degree_above": 0,
                "management_experience": 1,
                "gender": 2,
                "publisher": 82752,
                "publisher_name": null,
                "work_address": "",
                "is_hiring": 0,
                "underlings": 0,
                "language_required": 0,
                "target_industry": 0,
                "current_status": 0,
                "is_referral": 0,
                "ext_vo": {
                    "job_custom_id": 0,
                    "create_time": "1585648906000",
                    "update_time": "1585648906000",
                    "job_occupation_id": 0,
                    "pid": 19551566,
                    "extra": null,
                    "ext": "ext3"
                },
                "custom_fields": [
                    {
                        "id": 123,
                        "config_type": 1,
                        "config_name": "职位自定义字段",
                        "value": "职位自定义字段下的选项"
                    },
                    {
                        "id": 124,
                        "config_type": 2,
                        "config_name": "职能自定义字段",
                        "value": "字段二的选项"
                    },
                    {
                        "id": 125,
                        "config_type": 3,
                        "config_name": "职位自定义字段三",
                        "value": "字段三的选项"
                    }
                ],
                "addresses": [
                    {
                        "id": 1,
                        "address_name": "默认1111",
                        "company_id": 39978,
                        "province": null,
                        "city": 320500,
                        "region": null,
                        "address": "address_t",
                        "department_id": 0,
                        "department_name": null,
                        "longitude": "116.3974510",
                        "latitude": "39.9091870",
                        "point": null
                    }
                ]
            }
        ],
        "page_size": 1
    }
}

新建职位

此接口用于创建新职位使用.

Method：POST
Host：https://openapi.moseeker.com/v1
Path：/positions

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
job_number	Yes	string	第三方职位id
title	Yes	string	职位标题
publisher	Yes	string	HR在MoATS上的id
cities	Yes	array	工作城市(限10个)
requirement	Yes	string	职位要求
accountabilities	Yes	string	职位描述
process_id	Yes	integer	流程id
candidate_source	No	integer	招聘类型
employment_type	No	integer	工作性质
not_office	No	integer	非Office职位
salary_top	No	integer	薪资上限(k)
salary_bottom	No	integer	薪资下限(k)
experience	No	string	工作经验(年)
language	No	string	外语要求
count	No	integer	招聘人数(0：不限)
ext	No	string	职位扩展字段
address_id	No	array	LBS
team_id	No	integer	部门
job_custom_id	No	string	职位自定义
features	No	array	福利特色
is_referral	No	integer	是否内推（1：是，0：否）
degree	No	integer	学历要求 ( 0:无, 1:大专, 2:本科, 3:硕士, 4:MBA, 5:博士, 6:中专, 7:高中, 8:博士后, 9:初中)
top	No	boolean	置顶标签。true表示置顶，false表示未置顶
coordinator_id	No	string	招聘协助HR id,多个id逗号分割
custom_fields	No	array	职位自定义字段信息

招聘类型

Code	Describe
0	社招
1	校招

工作性质

Code	Describe
0	全职
1	兼职
2	合同工
3	实习
9	其他

学历要求

Code	Describe
0	没有要求
1	大专
2	本科
3	硕士
4	MBA
5	博士
6	中专
7	高中
8	博士后
9	初中

{
    "job_number":"JOB_NUMBER_0514_1",
    "title":"test_title",
    "publisher":"82752",
    "cities":[320500],
    "requirement":"职位要求",
    "accountabilities":"职位描述",
    "process_id":1,
    "candidate_source":0,
    "employment_type":0,
    "not_office":0,
    "salary_top":100,
    "salary_bottom":10,
    "experience":"3",
    "language":"英语",
    "count":1,
    "ext":"ext",
    "address_id":[1,2],
    "team_id":188365542,
    "job_custom_id":"47",
    "features":[119,145],
    "is_referral": "1",
    "degree":1,
    "top":true,
    "coordinator_id":"111111,222222",
    "custom_fields": [
        {
            "config_type": 1,
            "value": "职位自定义字段下的选项"
        },
        {
            "config_type": 2,
            "value": "职位自定义字段二的选项"
        },
        {
            "config_type": 3,
            "value": "职位自定义字段三的选项"
        }
    ]
}

{
    "code": 0,
    "message": "",
    "data": {
        "id": 19557723,
        "job_number": "JOB_NUMBER_0514_1",
        "title": "title",
        "team": {
            "id": 188365542,
            "name": "1"
        },
        "cities": [
            {
                "code": 320500,
                "name": "苏州",
                "level": 2,
                "hot_city": true,
                "ename": "Suzhou",
                "is_using": true,
                "cities": null
            }
        ],
        "publish_date": "2020-05-14 09:51:21",
        "stop_date": null,
        "accountability": null,
        "experience": "3",
        "experience_above": 0,
        "requirement": "职位要求",
        "language": "英语",
        "update_time": "2020-05-14 09:51:21",
        "business_group": "",
        "employment_type": 0,
        "hr_email": null,
        "degree": 0,
        "degree_above": 0,
        "top":true,
        "coordinator_name": "协助HR姓名",
        "coordinator_id":"1000211",      
        "features": [
            {
                "id": 119,
                "company_id": 39978,
                "name": "班车",
                "create_time": "2018-03-06 21:04:10",
                "update_time": "2019-10-14 17:32:11",
                "status": "有效"
            },
            {
                "id": 145,
                "company_id": 39978,
                "name": "加班补助",
                "create_time": "2018-03-06 21:04:12",
                "update_time": "2019-10-28 15:59:21",
                "status": "有效"
            }
        ],
        "email_notice": 0,
        "candidate_source": 0,
        "occupation": "",
        "is_recom": 1,
        "industry": "",
        "district": "",
        "count": 1,
        "salary_top": 100,
        "salary_bottom": 10,
        "management_experience": 1,
        "gender": 2,
        "publisher": 82752,
        "publisher_name": null,
        "work_address": "",
        "is_hiring": 0,
        "underlings": 0,
        "language_required": 0,
        "target_industry": 0,
        "is_referral": 1,
        "ext_vo": {
            "job_custom_id": 47,
            "create_time": "1589421081000",
            "update_time": "1589421081000",
            "job_occupation_id": 0,
            "pid": 19557723,
            "extra": null,
            "ext": "ext"
        },
        "custom_fields": [
            {
                "id": 123,
                "config_type": 1,
                "config_name": "职位自定义字段",
                "value": "职位自定义字段下的选项"
            },
            {
                "id": 124,
                "config_type": 2,
                "config_name": "职能自定义字段",
                "value": "职位自定义字段二的选项"
            },
            {
                "id": 125,
                "config_type": 3,
                "config_name": "职位自定义字段三",
                "value": "职位自定义字段三的选项"
            }
        ],
        "addresses": [
            {
                "id": 1,
                "address_name": "默认1",
                "company_id": 39978,
                "province": null,
                "city": 320500,
                "region": null,
                "address": "address_t",
                "department_id": 0,
                "department_name": null,
                "longitude": "116.3974510",
                "latitude": "39.9091870",
                "point": null
            }
        ]
    }
}

更新职位

此接口用于更新已存在职位信息.

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/positions/{id}

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Path Parameters

Key	Required	Type	Description
id	Yes	number	职位id

Body Parameters

Key	Required	Type	Description
title	Yes	string	职位标题
publisher	Yes	string	HR在MoATS上的id
cities	Yes	array	工作城市(限10个)
requirement	Yes	string	职位要求
accountabilities	Yes	string	职位描述
candidate_source	No	integer	招聘类型
employment_type	No	integer	工作性质
not_office	No	integer	非Office职位
salary_top	No	integer	薪资上限(k)
salary_bottom	No	integer	薪资下限(k)
experience	No	string	工作经验(年)
language	No	string	外语要求
count	No	integer	招聘人数(0：不限)
ext	No	string	职位扩展字段
address_id	No	array	LBS
team_id	No	integer	团队
job_custom_id	No	string	职位自定义
features	No	array	福利特色
is_referral	No	integer	是否内推（1：是，0：否）
degree	No	integer	学历要求 ( 0:无, 1:大专, 2:本科, 3:硕士, 4:MBA, 5:博士, 6:中专, 7:高中, 8:博士后, 9:初中)
top	No	boolean	置顶标签。true表示置顶，false表示未置顶
coordinator_id	No	string	招聘协助HR id 多个id逗号分割
custom_fields	No	array	职位自定义字段信息

{
    "title":"manager1",
    "requirement":"职位要求",
    "accountabilities":"职位描述",
    "experience":"3",
    "language":"英语",
    "count":1,
    "publisher":"82752",
    "cities":[1,2,3],
    "salary_top":100,
    "salary_bottom":10,
    "candidate_source":0,
    "employment_type":0,
    "not_office":0,
    "process_id":1,
    "ext":"ext3",
    "address_id":[1,2,3],
    "team_id":188365542,
    "job_custom_id":"2",
    "features":[119,145],
    "is_referral":"1",
    "degree":2,
    "top":true,
    "coordinator_id":"1111111,2222222",
    "custom_fields": [
        {
            "config_type": 1,
            "value": "职位自定义字段下的选项"
        },
        {
            "config_type": 2,
            "value": "职位自定义字段二的选项"
        },
        {
            "config_type": 3,
            "value": "职位自定义字段三的选项"
        }
    ]
}

{
    "code": 0,
    "message": "",
    "data": {
        "id": 19551603,
        "job_number": "JOB20200402_5",
        "title": "manager1",
        "team": {
                    "id": 188365533,
                    "name": "万达集团"
                },
        "cities": [
            {
                "code": 320500,
                "name": "苏州",
                "level": 2,
                "hot_city": true,
                "ename": "Suzhou",
                "is_using": true,
                "cities": null
            }
        ],
        "publish_date": "2020-04-02 12:04:21",
        "stop_date": null,
        "accountability": null,
        "experience": "3",
        "experience_above": 0,
        "requirement": "职位要求",
        "language": "英语",
        "update_time": "2020-04-02 13:21:42",
        "business_group": "",
        "employment_type": 0,
        "hr_email": null,
        "degree": 0,
        "degree_above": 0,
        "features": [
            {
                "id": 119,
                "company_id": 39978,
                "name": "班车",
                "create_time": "2018-03-06 21:04:10",
                "update_time": "2019-10-14 17:32:11",
                "status": "有效"
            },
            {
                "id": 145,
                "company_id": 39978,
                "name": "加班补助",
                "create_time": "2018-03-06 21:04:12",
                "update_time": "2019-10-28 15:59:21",
                "status": "有效"
            }
        ],
        "email_notice": 0,
        "candidate_source": 0,
        "occupation": "",
        "is_recom": 1,
        "industry": "",
        "district": "",
        "count": 1,
        "salary_top": 100,
        "salary_bottom": 10,
        "management_experience": 1,
        "gender": 2,
        "publisher": 82752,
        "publisher_name": null,
        "work_address": "",
        "is_hiring": 0,
        "underlings": 0,
        "language_required": 0,
        "target_industry": 0,
        "is_referral": 1,
        "top":true, 
        "coordinator_name": "协助HR姓名1,协助HR姓名2", 
        "coordinator_id":"1111111,2222222",   
        "ext_vo": {
            "job_custom_id": 0,
            "create_time": "1585800261000",
            "update_time": "1585800261000",
            "job_occupation_id": 0,
            "pid": 19551603,
            "extra": null,
            "ext": "ext3"
        },
        "custom_fields": [
            {
                "id": 123,
                "config_type": 1,
                "config_name": "职位自定义字段",
                "value": "职位自定义字段下的选项"
            },
            {
                "id": 124,
                "config_type": 2,
                "config_name": "职能自定义字段",
                "value": "职位自定义字段二的选项"
            },
            {
                "id": 125,
                "config_type": 3,
                "config_name": "职位自定义字段三",
                "value": "职位自定义字段三的选项"
            }
        ],
        "addresses": [
            {
                "id": 1,
                "address_name": "默认1111",
                "company_id": 39978,
                "province": null,
                "city": 320500,
                "region": null,
                "address": "address_t",
                "department_id": 0,
                "department_name": null,
                "longitude": "116.3974510",
                "latitude": "39.9091870",
                "point": null
            }
        ]
    }
}

更新职位状态

该接口可以使你撤下已经发布的职位.

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/positions/{id}/status

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
hr_id	Yes	string	HR在MoAts上的id
status	Yes	integer	职位状态

职位状态

Code	Describe
0	上架
2	下架

Response data

Key	Describe
amount	数量

{
    "hr_id": "82752",
    "status": 2
}

{
    "code": 0,
    "message": 1,
    "data": {
        "amount": 1
    }
}

获取职位自定义列表

获取本公司所有职位自定义

Get Position Custom

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/positions/custom

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Response data

Key	Describe
id	自定义字段id
status	状态
name	名字

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 47,
            "status": "有效",
            "name": "Corporate Functions & Other"
        },
        {
            "id": 52,
            "status": "有效",
            "name": "Customer Support"
        }
    ]
}

获取职位福利特色

获取本公司所有福利特色

Get Position Features

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/positions/feature

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Response data

Key	Describe
id	福利特色id
company_id	公司id
name	名字
create_time	创建时间
update_time	更新时间
status	状态

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 119,
            "company_id": 39978,
            "name": "福利特色1",
            "create_time": "2018-03-06 21:04:10",
            "update_time": "2019-10-14 17:32:11",
            "status": "有效"
        },
        {
            "id": 145,
            "company_id": 39978,
            "name": "福利特色2",
            "create_time": "2018-03-06 21:04:12",
            "update_time": "2019-10-28 15:59:21",
            "status": "有效"
        }
    ]
}

职位配置申请表

将职位绑定到指定的申请表

link positions to application form

Method：POST
Host：https://openapi.moseeker.com/v1
Path：/positions/application-form

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
form_id	yes	string	表单编号
position_ids	yes	arrat	职位编号集合, 比如: [1,2,3,4,5]

{
    "form_id": "gQ",
    "position_ids": [
        2288317
    ]
}

{
    "code": 0,
    "message": ""
}

申请

获取申请

此接口用户获取单个申请.

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/applications

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Query Parameters

Key	Required	Type	Description
ats_status	No	string	申请同步状态
stage_id	No	integer	阶段Id
page_num	No	integer	页码
page_size	No	integer	数量
start_time	No	string	申请的开始时间 ('%Y-%m-%d %H:%M:%S')
end_time	No	string	申请的结束时间 ('%Y-%m-%d %H:%M:%S')

申请同步状态

Code	Describe
1	未同步
3	同步成功

Response data

Key	Describe
id	申请id
position_id	职位id
process_id	流程id
stage_id	阶段id
name	姓名
gender_name	性别名
head_img	头像
city_code	城市id
nationality_name	国籍名
current_job	当前工作
city_name	城市名
constellation	星座
country_code	国家id
email	邮箱
qq	QQ号
mobile	电话
birth	生日
self_introduction	自我评价
motto	座右铭
source_name	申请来源
languages	语言
> level	等级
> name	描述
credentials	证书
> score	分数
> organization	组织
> name	描述
educations	教育经历
> start_date	开始时间
> end_date	结束时间
> end_until_now	至今
> degree_name	学历
> college_name	学校名称
> country_name	国家
> major_name	专业
> description	描述
workexps	工作经历
> start_date	开始时间
> end_date	结束时间
> end_until_now	至今
> company_scale_name	公司规模
> department_name	部门名称
> job	工作名
> position_code	职位编码
> position_name	职位名
> achievement	成就
> company_name	公司名
> description	描述
awards	获奖情况
skills	技能
> name	名称
> level	等级
projectexps	项目经验
> start_date	开始时间
> end_date	结束时间
> end_until_now	至今
> name	名称
> role	项目角色
> company_name	公司名
> achievement	成绩
> responsibility	责任
> description	项目描述
intentions	意向
> work_state_name	是否在职
> salary_code_name	期望薪资
> consider_venture_company_opportunities	是否考虑创业公司机会
> work_type_name	工作类型
> cities	城市
> > city_name	城市名
> > city_code	城市id
> positions	职位
> > position_code	职位id
> > position_name	职位名称
> industries	行业
> > industry_name	行业名称
> > industry_code	行业id
referral	内推人
> name	称呼
> mobile	手机号码
> email	邮箱
> ext	其他信息（如果是工号认证，那么ext返回的是工号）

{
    "code": 0,
    "message": "",
    "data": {
        "total": 7,
        "page": 2,
        "data": [
            {
                "id": 2698479,
                "position_id": 19530149,
                "process_id": 0,
                "stage_id": 0,
                "name": "name",
                "gender_name": "男",
                "head_img": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTJ7qCurHcjRLmomBNLVSs43XlRxM9mXciaribEIhGoBxumyeh014zaOicBOraAcoJV3pFkMyBCt8ZcWg/132",
                "city_code": 310000,
                "nationality_name": "中国",
                "current_job": "软件测试工程师",
                "city_name": "上海",
                "constellation": "金牛座",
                "country_code": "86",
                "email": "123@qq.com",
                "qq": "",
                "mobile": "15998601386",
                "birth": "1994-05-01",
                "self_introduction": "***",
                "motto": "",
                "source_name": null,
                "languages": [
                    {
                        "level": 2,
                        "name": "英语"
                    }
                ],
                "credentials": [
                    {
                        "score": "",
                        "organization": "",
                        "name": "大学英语六级"
                    }
                ],
                "educations": [
                    {
                        "start_date": "2018-01-01",
                        "end_date": null,
                        "end_until_now": 1,
                        "degree_name": "中专",
                        "college_name": "Can Tho University",
                        "country_name": "越南社会主义共和国",
                        "major_name": "应用心理学",
                        "description": ""
                    }                ],
                "workexps": [
                    {
                        "start_date": "2015-07-01",
                        "end_date": "2019-09-09",
                        "end_until_now": 1,
                        "company_scale_name": "请选择企业规模",
                        "department_name": "111",
                        "job": "软件测试工程师",
                        "position_code": 0,
                        "position_name": "",
                        "achievement": "",
                        "company_name": "软通动力信息技术(集团)有限公司",
                        "description": "保证开发软件的质量，测试流程控制，编写测试用例，跟踪bug"
                    }                ],
                "awards": [],
                "skills": [
                    {
                        "name": "python语言",
                        "level": 1
                    }
                ],
                "projectexps": [
                    {
                        "start_date": "2015-09-01",
                        "end_date": "2017-02-01",
                        "end_until_now": 0,
                        "name": "手机银行APP测试",
                        "role": "",
                        "company_name": "",
                        "achievement": "",
                        "responsibility": "",
                        "description": "项目描述：\n测试项目流程梳理，迭代项目质量把控，评估测试时间，测试用例合理性等\n\n项目职责：\nfd"
                    }
                ],
                "intentions": [
                    {
                        "work_state_name": "",
                        "salary_code_name": "25k及以上",
                        "consider_venture_company_opportunities": "",
                        "work_type_name": "兼职",
                        "cities": [
                            {
                                "city_name": "上海",
                                "city_code": 310000
                            }
                        ],
                        "positions": [
                            {
                                "position_code": 180300,
                                "position_name": "项目管理/项目协调"
                            }
                        ],
                        "industries": [
                            {
                                "industry_name": "互联网/电子商务",
                                "industry_code": 0
                            }
                        ]
                    }
                ],
                "referral": {
                    "name": "name",
                    "mobile": "15000869284",
                    "email": "247334622@qq.com",
                    "ext": "ER0001"
                }
            }
        ],
        "page_size": 1
    }
}

获取申请的简历附件

此接口用户获取单个简历附件.

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/applications/{id}/attachment

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Path Parameters

Key	Required	Type	Description
id	Yes	number	申请id

Response data

Key	Describe
type	类型
content	简历(base64)
profile_content	简历原件为null时，请取标准简历附件(base64)
profile_type	profileContent对应文件类型（支持pdf，docx）
profile_name	profileContent对应文件名

{
    "code": 0,
    "message": "",
    "data": {
        "type": "pdf",
        "content": "****",
        "profile_content": "****",
        "profile_type": "pdf",
        "profile_name": "测试简历.pdf"
    }
}

申请同步状态

此接口用于修改申请在MoSeeker状态. 目前只支持修改ats_status=3 其他的暂时不接受修改.

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/applications/{id}/status

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Path Parameters

Key	Required	Type	Description
id	Yes	number	申请id

Body Parameters

Key	Required	Type	Description
ats_status	Yes	string	同步状态(3：同步成功)

Response data

Key	Describe
amount	修改成功数量

{
    "ats_status": 3
}

{
    "code": 0,
    "message": "",
    "data": {
        "amount": 1
    }
}

申请流程状态

此接口用于修改申请在MoSeeker流程状态。简历的归档、淘汰、入职需要另行调用“简历归档”接口。

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/applications/{id}/process

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Path Parameters

Key	Required	Type	Description
id	Yes	number	申请id

Body Parameters

Key	Required	Type	Description
hr_id	Yes	integer	HR id
stage_id	Yes	integer	阶段id

Response data

Key	Describe
amount	修改成功数量

{
    "hr_id": "82752",
    "stage_id": 13
}

{
    "code": 0,
    "message": "",
    "data": {
        "amount": 1
    }
}

获取CV

此接口用于获取CV数据

Method: GET
Host: https://openapi.moseeker.com/v1
Path: /applications/cv

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Query Parameters

Key	Required	Type	Description
page_num	No	integer	页码
page_size	No	integer	数量
stage_id	No	integer	阶段ID
start_time	No	string	申请的开始时间('%Y-%m-%d %H:%M:%S')
end_time	No	string	申请的结束时间('%Y-%m-%d %H:%M:%S')

Response data

Key	Describe
id	申请id
candidate_profile_id	候选人简历id
candidate_source	候选人来源
company_id	公司id
job_number	第三方职位id
l_application_id	ATS 申请ID
origin	申请来源
position_id	职位ID
profile_id	简历ID
stage_id	阶段ID
submit_time	申请时间
user_id	用户ID
awards	获得奖项
> name	奖项名称
> time	获奖时间
basic	基础信息
> credentials_number	证件号
> credentials_type	证件类型
>> code	证件名称
>> name	证件代码
> nationality	国籍
>> code	国家代码
>> name	国家名称
> recent_company	最近公司
> recent_work	最新担任职位
> salary	当前薪资
> self_description	自我评价
> certificates	证书信息
>> code	证书编号
>> get_date	获取日期
>> name	证书名称
>> organization	主办方
>> score	分数
>> url	链接
educations	教育经历
> college	学校信息
>> code	学校代码
>> name	学校名称
> degree	学历
> description	描述
> start_time	开始时间
> end_time	结束时间
> end_until_now	至今
> gpa	GPA
> major	专业
intention	求职意向
> cities	期望工作城市
>> name	城市名
>> code	城市代码
> expected_salary	期望薪资
> industries	期望行业
>> name	行业名
>> code	行业ID
> positions	期望职位
>> name	职位名
>> code	职位代码
> work_state	在职状态
>> name	状态名
>> code	状态代码
> work_type	工作类型
>> name	工作类型名称
>> code	类型代码
languages	语言
> level	等级
> name	描述
overview	摘要信息
> age	年龄
> area_code	区号
> birth	生日
> city	当前所在城市
>> name	城市名
>> code	城市ID
> country_code	国家代码
> degree	最高学历
> email	邮箱
> gender	性别
>> code	性别代码
>> name	性别名称
> mobile	手机号
> name	姓名
> qq	QQ
> wechat	微信
> wechat_avatar	微信头像
> work_years	工作年限
project_experiences	项目经验
> start_time	开始时间
> end_time	结束时间
> end_until_now	至今
> name	名称
> role	项目角色
> company	公司名
> responsability	责任
> description	项目描述
skills	技能
> name	名称
> level	等级
work_experiences	工作经历
> start_time	开始时间
> end_time	结束时间
> end_until_now	至今
> department	部门名称
> job	工作名
> company	公司名
> description	描述
works	个人作品
> cover	作品封面
> url	作品链接
> description	作品描述
referral	内推人
> name	称呼
> mobile	手机号码
> email	邮箱
> ext	其他信息（如果是工号认证，那么ext返回的是工号）
form_group	公司下的自定义分组
> group_id	模块ID
> group_title_zh	模块中文名
> group_title_en	模块英文名
> form_field_lists	模块下的自定义字段
>> form_field_vo	模块下的自定义字段
>>> field_id	字段id
>>> field_title_zh	控件中文名
>>> field_title_en	控件英文名
>>> string_value	值
>>> string_value_enum	枚举值
>>>> name	值枚举编码
>>>> code	值枚举名称
>>> multi_value	（多选类型）值
>>> multi_value_enum	（多选类型）枚举值
>>> time_value	时间值
>>>> start_time	开始时间
>>>> end_time	结束时间
>>>> end_until_now	是否至今

{
  "code": 0,
  "message": "",
  "data": {
    "total": 5236,
    "page": 1,
    "data": [
      {
        "id": 0,
        "candidate_profile_id": "12",
        "candidate_source": "51",
        "company_id": 0,
        "job_number": "R1207",
        "l_application_id": 0,
        "origin": 0,
        "position_id": 0,
        "profile_id": 0,
        "stage_id": 0,
        "submit_time": "2020-09-16 08:23:38",
        "user_id": 0,
        "awards": [
          {
            "name": "英语四级",
            "time": "2020-09-16"
          }
        ],
        "basic": {
          "credentials_number": "32154252641642132",
          "credentials_type": {
            "code": "1",
            "name": "身份证"
          },
          "nationality": {
            "code": "86",
            "name": "中国"
          },
          "recent_company": "大岂科技",
          "recentWork": "后端开发",
          "salary": "15000",
          "self_description": "活泼开朗"
        },
        "certificates": [
          {
            "code": "21563366",
            "get_date": "2020-09-16 08:23:38",
            "name": "蓝桥杯全国二等奖",
            "organization": "蓝桥杯",
            "score": "99",
            "url": ""
          }
        ],
        "educations": [
          {
            "college": {
              "code": "66",
              "name": "南京航空航天大学"
            },
            "degree": {
              "code": "1",
              "name": "硕士"
            },
            "description": "本硕连读",
            "end_time": "2020-06-15",
            "end_until_now": 0,
            "gpa": 0,
            "major": {
              "code": "1",
              "name": "软件工程"
            },
            "start_time": "2013-09-13"
          }
        ],
        "intention": {
          "cities": [
            {
              "code": "65",
              "name": "上海"
            }
          ],
          "expected_salary": "20000",
          "industries": [
            {
              "code": "22",
              "name": "互联网"
            }
          ],
          "positions": [
            {
              "code": "45",
              "name": "软件"
            }
          ],
          "work_state": {
            "code": "22",
            "name": "在职"
          },
          "work_type": {
            "code": "22",
            "name": "全职"
          }
        },
        "languages": [
          {
            "level": "1",
            "name": "一级甲等"
          }
        ],
        "overview": {
          "age": 0,
          "area_code": "string",
          "birth": "string",
          "city": {
            "code": "22",
            "name": "上海"
          },
          "country_code": "86",
          "degree": 1,
          "email": "123@123.com",
          "gender": {
            "code": 1,
            "name": "女"
          },
          "mobile": "15266699978",
          "name": "李丽",
          "qq": "123456789",
          "wechat": "121212",
          "wechat_avatar": "",
          "work_years": 1
        },
        "project_exp": [
          {
            "company": "大器",
            "description": "制造业Saas",
            "end_time": "2012-02-12",
            "end_until_now": 0,
            "name": "制造业Saas系统",
            "responsability": "业务开发",
            "role": "项目负责人",
            "start_time": "2019-02-12"
          }
        ],
        "skills": [
          {
            "level": 0,
            "name": "Linux"
          }
        ],
        "work_exp": [
          {
            "company": "大器",
            "department": "研发部",
            "description": "业务开发",
            "end_time": "2020-03-15",
            "end_until_now": 0,
            "job": "全栈开发",
            "start_time": "2019-02-12"
          }
        ],
        "works": [
          {
            "cover": "暂无",
            "description": "后台管理开源框架",
            "url": "暂无"
          }
        ],
        "referral": {
          "name": "name",
          "mobile": "15000869284",
          "email": "247334622@qq.com",
          "ext": "ER0001"
        },
        "form_group": [
          {
            "group_id": 2,
            "group_title_en": "Basic",
            "group_title_zh": "基本信息",
            "form_field_lists": [
              {
                "form_field_vo": [
                  {
                    "field_id": 550,
                    "field_title_en": null,
                    "field_title_zh": "测试多选2",
                    "string_value": null,
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [
                      "152900",
                      "310000"
                    ],
                    "multi_value_enum": [
                      {
                        "code": "152900",
                        "name": "阿拉善盟"
                      },
                      {
                        "code": "310000",
                        "name": "上海"
                      }
                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  }
                ]
              }
            ]
          },
          {
            "group_id": 4,
            "group_title_en": "Project Experience",
            "group_title_zh": "项目经历",
            "form_field_lists": [
              {
                "form_field_vo": [

                ]
              }
            ]
          },
          {
            "group_id": 7,
            "group_title_en": "Skill",
            "group_title_zh": "技能",
            "form_field_lists": [
              {
                "form_field_vo": [

                ]
              }
            ]
          },
          {
            "group_id": 9,
            "group_title_en": "Certificate",
            "group_title_zh": "证书",
            "form_field_lists": [
              {
                "form_field_vo": [

                ]
              }
            ]
          },
          {
            "group_id": 11,
            "group_title_en": "Score",
            "group_title_zh": "考试成绩",
            "form_field_lists": [
              {
                "form_field_vo": [
                  {
                    "field_id": 75,
                    "field_title_en": "CET 6 Score",
                    "field_title_zh": "大学英语六级成绩",
                    "string_value": "520",
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 593,
                    "field_title_en": null,
                    "field_title_zh": "考试成绩模块(自定义模块)图片01",
                    "string_value": "file://appform/headimg/202206/7b221589187046908bffac97c2ada6a6_9333614E-D622-4DC6-8F78-BFBCB2EF7C02.jpeg?belong=fNyVexxxxe",
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  }
                ]
              }
            ]
          },
          {
            "group_id": 14,
            "group_title_en": "Others",
            "group_title_zh": "其他",
            "form_field_lists": [
              {
                "form_field_vo": [
                  {
                    "field_id": 106,
                    "field_title_en": "Latest Position",
                    "field_title_zh": "最近职位",
                    "string_value": "java开发",
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 107,
                    "field_title_en": "Current Industry",
                    "field_title_zh": "当前行业",
                    "string_value": "1101",
                    "string_value_enum": {
                      "code": "1101",
                      "name": "计算机软件"
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 105,
                    "field_title_en": "Are you staying on the job",
                    "field_title_zh": "目前是否在职",
                    "string_value": "1",
                    "string_value_enum": {
                      "code": "1",
                      "name": "是"
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 104,
                    "field_title_en": "Latest Company/Brand",
                    "field_title_zh": "最近工作的公司/品牌",
                    "string_value": "阿里巴巴",
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 100,
                    "field_title_en": "Current Annual Salary",
                    "field_title_zh": "当前年薪",
                    "string_value": "1",
                    "string_value_enum": {
                      "code": "1",
                      "name": "6万以下"
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  }
                ]
              }
            ]
          },
          {
            "group_id": 164,
            "group_title_en": null,
            "group_title_zh": "ZZ自定义",
            "form_field_lists": [
              {
                "form_field_vo": [
                  {
                    "field_id": 648,
                    "field_title_en": null,
                    "field_title_zh": "单行文本1",
                    "string_value": "黄金卷",
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 649,
                    "field_title_en": null,
                    "field_title_zh": "多行文本1",
                    "string_value": "京津冀",
                    "string_value_enum": {
                      "code": null,
                      "name": null
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  },
                  {
                    "field_id": 650,
                    "field_title_en": null,
                    "field_title_zh": "单选字段",
                    "string_value": "2",
                    "string_value_enum": {
                      "code": "2",
                      "name": "1"
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  }
                ]
              }
            ]
          },
          {
            "group_id": 167,
            "group_title_en": null,
            "group_title_zh": "测试模块新增沙盒",
            "form_field_lists": [
              {
                "form_field_vo": [
                  {
                    "field_id": 653,
                    "field_title_en": null,
                    "field_title_zh": "测试",
                    "string_value": "1",
                    "string_value_enum": {
                      "code": "1",
                      "name": "12345"
                    },
                    "multi_value": [

                    ],
                    "multi_value_enum": [

                    ],
                    "time_value": {
                      "start_time": null,
                      "end_time": null,
                      "end_until_now": null
                    }
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "page_size": 10
  }
}

简历归档

Method：POST
Host：https://openapi.moseeker.com/v1
Path：/applications/pigeonhole

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
candidate_ids	Yes	array[integer]	申请编号数组
hr_id	Yes	integer	HR编号
type	Yes	integer	归档类型 1:入职 2:放弃入职 3:淘汰
description	Yes	string	归档原因说明

归档类型

Code	Describe
1	入职
2	放弃入职
3	淘汰

Response data

Key	Describe

{
    "candidate_ids":[3836230],
    "hr_id":82752,
    "type":1,
    "description":"说明"
}

{
    "code": 0,
    "message": "",
    "data": {}
}

申请表

获取申请表

分页获取本公司所有申请表.

Get Application Forms

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/application-forms

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Query Parameters

Key	Required	Type	Description
page_num	No	integer	页码
page_size	No	integer	数量

Response data

Key	Describe
id	申请表编号
title	中文名称
title_en	英文名称
description	中文描述
description_en	英文描述

{
    "code": 0,
    "message": "",
    "data": {
        "total": 1,
        "page": 1,
        "data": [
            {
                "id": "id",
                "title": "chinese title",
                "title_en": "english title",
                "description": "chinese description",
                "description_en": "english description"
            }
        ],
        "page_size": 10
    }
}

流程

获取本公司所有申请流程每个职位会绑定一个流程，用于区分申请的每个阶段

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/processes

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Response data

Key	Describe
id	流程id
name	流程名
description	描述
position_num	职位数量
stage_num	阶段数量

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "测试流程1",
            "description": "测试",
            "position_num": 35413,
            "stage_num": 5
        },
        {
            "id": 2,
            "name": "测试流程1",
            "description": "测试",
            "position_num": 183,
            "stage_num": 22
        }
    ]
}

流程阶段

使用此接口获取对应流程下的阶段信息

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/processes/{id}/stages

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Path Parameters

Key	Required	Type	Description
id	Yes	number	流程id

Response data

Key	Describe
id	阶段id
name	阶段名
order	阶段排序

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 225,
            "name": "初筛",
            "order": 1
        },
        {
            "id": 267,
            "name": "初面",
            "order": 2
        }
    ]
}

地址

获取LBS

（LBS）是一个通用术语，表示使用地理数据和信息向用户提供服务或信息的软件服务。 LBS可用于多种环境，例如健康，室内物体搜索，娱乐，工作，个人生活等。

获取本公司所有LBS地址.LBS是仟寻职位详情页的具体地址显示，以实现地址的地图导航功能.基于位置的服务

Get LBS Address

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/lbs

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Response data

Key	Describe
id	地址id
address_name	地址名称
province	省
city	市
region	区
address	详细地址
longitude	经度
latitude	纬度

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 1,
            "address_name": "默认1",
            "province": 320000,
            "city": 320200,
            "region": 320203,
            "address": "address1",
            "longitude": "117.0663820",
            "latitude": "36.6880690"
        },
        {
            "id": 2,
            "address_name": "默认2",
            "province": 650000,
            "city": 650100,
            "region": 650103,
            "address": "江岸区武汉市",
            "longitude": "121.0000000",
            "latitude": "31.0000000"
        }    
    ]
}

新增LBS

单个新增LBS地址.

Create LBS Address

Method：POST
Host：https://openapi.moseeker.com/v1
Path：/lbs

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
address	Yes	string	详细地址
address_name	Yes	string	地址名称
city	Yes	integer	市
latitude	No	float	纬度
longitude	No	float	经度

{
  "address": "address",
  "address_name": "address_name",
  "city": 320500,
  "latitude": 39.9091870,
  "longitude": 116.3974510
}

{
    "code": 0,
    "message": "",
    "data": 1
}

更新LBS

按照id更新LBS地址.

Update LBS Address

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/lbs/{id}

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
address	Yes	string	详细地址
address_name	Yes	string	地址名称
city	Yes	integer	市
latitude	Yes	float	纬度
longitude	Yes	float	经度

{
  "address": "address",
  "address_name": "address_name",
  "city": 320500,
  "latitude": 39.9091870,
  "longitude": 116.3974510
}

{
    "code": 0,
    "message": "",
    "data": 1
}

团队/部门

获取团队/部门

获取本公司所有团队/部门

Get Team

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/teams

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Response data

Key	Describe
id	团队/部门id
name	团队/部门名称
description	团队介绍

{
    "code":0,
    "message":"",
    "data":[
        {
            "id":188365529,
            "name":"Healthcare",
            "description":""
        },
        {
            "id":188365530,
            "name":"Office of General Counsel",
            "description":"111"
        }
    ]
}

获取组织架构树

获取本公司指定账号的组织架构树（主账号可见所有）

Get Organizational Tree

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/teams/tree

Headers

Key	Required	Type	Description
token	Yes	string	令牌
hr_id	Yes	int	hr id

Response data

Key	Describe
id	组织/团队/部门id
name	组织/团队/部门名称
parent_id	上级id
type	类型
type_label	类型名称
children	下级组织/团队/部门

{
    "code": 0,
    "message": "",
    "data": [
        {
            "children": [
                {
                    "children": [],
                    "company_id": 39978,
                    "name": "test team b update",
                    "parent_id": 188373785,
                    "id": 188373773,
                    "type": 2,
                    "type_label": "机构"
                }
            ],
            "company_id": 39978,
            "name": "Finance",
            "parent_id": 0,
            "id": 188373785,
            "type": 2,
            "type_label": "部门"
        }
    ]
}

账号

获取HR账号

获取本公司所有HR账号

Get HR Account

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/accounts

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Response data

Key	Describe
id	发布人id
company_id	公司id
mobile	电话
email	邮箱
user_name	名字
create_time	创建时间
update_time	更新时间
status	状态

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 82752,
            "mobile": "15000000000",
            "email": "publisher1@moseeker.com",
            "user_name": "发布人1",
            "create_time": "2016-07-20 14:31:05",
            "update_time": "2020-05-13 15:21:37",
            "status": "有效"
        },
        {
            "id": 82780,
            "mobile": "13111111111",
            "email": "publisher20@dqprism.com",
            "user_name": "发布人2",
            "create_time": "2016-08-01 15:17:19",
            "update_time": "2020-04-16 13:36:09",
            "status": "有效"
        }
    ]
}

新增账号

新增HR账号。超级管理员不能新增。

Create HR Account

Method：POST
Host：https://openapi.moseeker.com/v1
Path：/account

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
role_type	Yes	integer	角色类型 2:管理员 3:HR 4:高级用人经理 5:用人经理 6:面试官
user_name	Yes	string	姓名
mobile	Yes	string	手机号
email	Yes	string	邮箱
deparment_name	No	string	所属组织名称。角色类型为管理员、HR时，不能设置组织。
managed_department_name	No	string	负责组织名称。角色类型为管理员、HR时，必须设置负责组织。角色类型为高级用人经理、用人经理、面试官时，不能设置负责组织。多个名称用,分隔。
job_number	No	string	工号

{
    "role_type": 4,
    "user_name": "高级用人经理1",
    "mobile": "15000000000",
    "email": "15000000000@moseeker.com",
    "deparment_name": "组织名称1",
    "managed_department_name": "组织名称1",
    "job_number": "123456"
}

Response data

Key	Describe
code	响应编码，0代表成功
message	响应信息
data	响应数据

{
    "code": 0,
    "message": "",
    "data": true
}

修改账号

修改HR账号。超级管理员不能修改。

Update HR Account

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/account

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
role_type	Yes	integer	角色类型 2:管理员 3:HR 4:高级用人经理 5:用人经理 6:面试官
user_name	Yes	string	姓名
mobile	Yes	string	手机号
email	Yes	string	邮箱
deparment_name	No	string	所属组织名称。角色类型为管理员、HR时，不能设置组织。
managed_department_name	No	string	负责组织名称。角色类型为管理员、HR时，必须设置负责组织。角色类型为高级用人经理、用人经理、面试官时，不能设置负责组织。多个名称用,分隔。
job_number	No	string	工号
update_type	Yes	integer	0:按照手机号 1:按照工号

{
    "role_type": 4,
    "user_name": "高级用人经理1",
    "mobile": "15000000000",
    "email": "15000000000@moseeker.com",
    "deparment_name": "组织名称1",
    "managed_department_name": "组织名称1",
    "job_number": "123456",
    "update_type":0
}

Response data

Key	Describe
code	响应编码，0代表成功
message	响应信息
data	响应数据

{
    "code": 0,
    "message": "",
    "data": true
}

禁用账号

禁用HR账号，手机号、工号至少填写一个。超级管理员不能禁用。

Disable HR Account

Method：PUT
Host：https://openapi.moseeker.com/v1
Path：/account/disable

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
mobile	Yes	string	手机号
job_number	No	string	工号
update_type	Yes	integer	0:按照手机号 1:按照工号

{
    "mobile": "15000000000",
    "job_number": "",
    "update_type":0
}

Response data

Key	Describe
code	响应编码，0代表成功
message	响应信息
data	响应数据

{
    "code": 0,
    "message": "",
    "data": true
}

按角色查询账号

Get HR Account by role

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/account/roletype

Headers

Key	Required	Type	Description
token	Yes	string	令牌

Body Parameters

Key	Required	Type	Description
role_type	Yes	string	多个角色用,分隔。角色类型 1:超级管理员 2:管理员 3:HR 4:高级用人经理 5:用人经理 6:面试官

Response data

Key	Describe
code	响应编码，0代表成功
message	响应信息
data	响应数据

{
    "code": 0,
    "message": "",
    "data": {
                "3": [{
                    "user_name": "HR",
                    "mobile": "15000000001",
                    "email": "15000000001@moseeker.com",
                    "deparment_name": "组织名称3",
                    "managed_department_name": "组织名称3",
                    "job_number": "123459"
                }],
                "4": [{
                    "user_name": "高级用人经理1",
                    "mobile": "15000000003",
                    "email": "15000000003@moseeker.com",
                    "deparment_name": "组织名称1",
                    "managed_department_name": "组织名称1",
                    "job_number": "123456"
                }, {
                    "user_name": "高级用人经理2",
                    "mobile": "15000000000",
                    "email": "15000000000@moseeker.com",
                    "deparment_name": "组织名称2",
                    "managed_department_name": "组织名称2",
                    "job_number": "123457"
                }]
            }
}

字典

城市

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/dictionaries/cities

Headers

Key	Required	Type	Description
token	Yes	string	令牌

{
    "code":0,
    "message":"",
    "data":{
        "city_data":[
            {
                "code":320000,
                "name":"江苏省",
                "level":1,
                "hot_city":false,
                "ename":"Jiangsusheng",
                "is_using":false,
                "cities":[]
            }
        ],
        "hot_city":[
            {
                "code":110000,
                "name":"北京",
                "level":1,
                "hot_city":true,
                "ename":"Beijing",
                "is_using":true,
                "cities":null
            }
        ]
    }
}

微信

公众号access_token

请提供调用方ip地址，MoSeeker需要将其配置进白名单

Method：GET
Host：https://openapi.moseeker.com/v1
Path：/wechat/access_token

Headers

Key	Required	Type	Description
token	Yes	string	令牌

{
    "code": 0,
    "message": "",
    "data": {
        "access_token": "*****"
    }
}

渠道集成

请求Gateway

https://openapi.moseeker.com
所有的请求都需要添加这个gateway前缀。如：

  curl --request POST \
  --url https://openapi.moseeker.com/api/partner/v1/job/pub/20489853 \
  --header 'token: CgEKDQoAAQIKBgwJCQ8DDAIBCQYJCwwGDgMABgENFgwqCwAHJyQPDx8IDA4KFAMHAgwFAj4DAQBFDUkJCAQjEgUNAA8NBAMbDAoMDA8KNgsNCQQHLz5jXAULaQZJMQkBKQEaDwcEDyIPAQEEOQwLEUAMAw4LQg0gBQQEKggLCVEKg2gDYgwHBQxvJgQLBw0_XDY-UjwHXQSDcwwNW0UIBguMDh8Oca4DCHlJBQ' \
  --header 'user-agent: vscode-restclient' \
  --data '{"salaryBottom": 30,"departmentName": "开发","feature": ["早晚班车"],"salaryTop": 50,"salaryMonth": 12,"channel": 2,"occupation": [["N14","N0073","N000773"]]}'

请求Headers

每个请求都需要token验证请求者的身份;

Key	Required	Type	Description
token	Yes	string	令牌

Path中的`position_id`参数

position_id来自POST /v1/positions的response.data.id，所以请先保存职位的数据到MoSeeker；

注意:调用保存职位数据后请妥善保存您自己内部的职位ID和MoSeeker的职位ID的映射关系，以便在后续接口中查询对应MoSeeker Position ID；

如记录一张表保存映射关系:

MoSeeker Position ID	Workday JobReq ID
30193	R-1283

如果需要MoSeeker方面提交简历数据到您的内部系统，请将该内部系统的投递职位ID填写到 MoSeeker Position job_number字段上，否则申请简历可能无法提交到您集成的系统的对应职位上。

Field	Required	Type	Description
position_id	Yes	string	职位ID,
channel	Yes	string	0: MoSeekr Wechat&PC, 1: 51job, 2: 猎聘 , 6: 最佳东方, 14: 实习僧

获取职位的可用的渠道账号

职位的发布人可分配不同的渠道账号，只有允许使用的账号才可以将职位发布到渠道上面去。在MoSeeker后台分配好渠道发布账号给职位的发布人后，这个接口就会有数据返回。

Method：GET
Path：/api/partner/v1/job/account/{position_id}

{
  "code": 0,
  "message": "",
  "data": [
    {
      "id": 2100,
      "channel": 1,
      "username": "tech"
    },
    {
      "id": 2739,
      "channel": 2,
      "username": "xxx"
    },
    {
      "id": 2738,
      "channel": 6,
      "username": "demo"
    },
    {
      "id": 2742,
      "channel": 14,
      "username": "xiafu@moseeker.com"
    }
  ]
}

发布一个职位到MoSeeker微信门户渠道

Method: POST
Path /api/partner/v1/job/pub/{position_id}

{
  "channel": 0 // 只用这个一个 channel = 0 即可, 表示开启MoSeeker职位的 `微信与门户` 渠道
}

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "channel": 0,
      "status": 1,
      "title": "软件工程师",
      "position_id": "20489853",
      "error": "",
      "create_time": ""
    }
  ]
}

职能数据和下拉数据说明

每个渠道的字段有下拉选项值并且这些值不尽相同，需要做mapping处理或者由发布页面展示这些下拉选项由发布人手动选择;

这个步骤可以获取这些数据；由于职能数据较多，分单独的接口提供出去，其他字段由于数据量较小，放到dropdown接口中提供。

获取猎聘渠道职能列表

Method：GET
Path：/api/partner/v1/job/occupation/2/{position_id}

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "candidate_source": 0,
      "code_other": "N22",
      "code": 340099,
      "level": 1,
      "children": [
        {
          "candidate_source": 0,
          "code_other": "N0101",
          "code": 340181,
          "level": 2,
          "children": [],
          "parent_id": 340099,
          "name": "贸易/关务",
          "en_name": "Trade/Customs",
          "parent_id_code": "N22",
          "status": 1
        },
        //...
        {
          "candidate_source": 0,
          "code_other": "N0121",
          "code": 340668,
          "level": 2,
          "children": [],
          "parent_id": 340099,
          "name": "仓储",
          "en_name": "Warehousing",
          "parent_id_code": "N22",
          "status": 1
        }
      ]
    }
  ]
}

获取猎聘的字段下拉枚举值列表

Method：GET
Path：/api/partner/v1/job/dropdown/2/{position_id}

{
  "code": "0",
  "message": "success",
  "data": {
    "feature": ["班车", "交通补贴", "工会福利"],
    "salary_month": [12, 13, 14, 15, 16, 17, 18]
  }
}

发布一个职位到猎聘渠道

Method: POST
Path /api/partner/v1/job/pub/{position_id}

{
  "salaryBottom": 30, // 最低薪资 30k
  "departmentName": "IT", // 部门名称
  "feature": ["通讯补贴"], // 职位的福利特色 来自于 dropdown 中的 feature 的枚举值
  "salaryTop": 50, // 最高薪资 50k
  "salaryMonth": 12, // 每年薪资的发放月数，来自于 dropdown 中的 salay_month 的枚举值
  "channel": 2, // 2 表示猎聘渠道
  "occupation": [
    // 来自于猎聘职能接口的 code_other 字段, 可以选择多个职能 建议使用一个
    [
      "N14", // 一级职能code
      "N0073", // 二级职能code
      "N000773" // 三级职能code
    ]
  ]
}

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "id": null,
      "channel": 2,
      "status": 3, // 发布报错 弹出错误信息(error)
      "title": "软件工程师",
      "account_id": 0,
      "position_id": 20489853,
      "error": "java.lang.IllegalArgumentException: 地址不能为空", // 错误信息, 如果发布成功 status = 1  error = ""
      "create_time": "2026-08-11 16:13:00"
    }
  ]
}

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "id": null,
      "channel": 2,
      "status": 3,
      "title": "软件工程师",
      "account_id": 0,
      "position_id": 20489853,
      "error": "职位地址和职位发布城市不一致", // 错误信息, 如果发布成功 status = 1  error = ""
      "create_time": "2026-08-11 16:17:53"
    }
  ]
}

{
  "code": "0",
  "message": "success",
  "data": []
}

获取最佳东方渠道职能列表

Method：GET
Path：/api/partner/v1/job/occupation/6/{position_id}

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "hassub": "1",
      "code": "010000",
      "sublist": [
        {
          "hassub": "1",
          "code": "010200",
          "sublist": [
            {
              "hassub": "0",
              "code": "010201",
              "value": "前厅部经理"
            },
            {
              "hassub": "0",
              "code": "010202",
              "value": "宾客服务经理/大堂副理"
            }
          ]
        }
      ]
    }
  ]
}

获取最佳东方的字段下拉枚举值列表

Method：GET
Path：/api/partner/v1/job/dropdown/6/{position_id}

{
  "code": "0",
  "message": "success",
  "data": {
    "language": [
      {
        "id": "11",
        "name": "中国普通话"
      },
      {
        "id": "12",
        "name": "粤语"
      },
      // ...
      {
        "id": "9",
        "name": "葡萄牙语"
      },
      {
        "id": "20",
        "name": "客家方言"
      },
      {
        "id": "10",
        "name": "意大利语"
      }
    ],
    "category": [
      {
        "id": "126767",
        "name": "test042001"
      },
      {
        "id": "83725",
        "name": "餐饮部"
      },
      {
        "id": "48243",
        "name": "接待部1"
      },
      // ...
      {
        "id": "66080",
        "name": "质检部"
      },
      {
        "id": "47866",
        "name": "咨询"
      }
    ]
  }
}

发布一个职位到最佳东方渠道

Method: POST
Path: /api/partner/v1/job/pub/{position_id}

{
  "startDate": "2026-07-30", // 招聘开始日期
  "endDate": "2026-09-30 00:00:00", // 招聘结束日期
  "salaryBottom": 4, // 最低薪资 4k
  "jobClassId": "126767", // 分类 来自于 dropdown category.id
  "linkman": "lin", // 联系人姓名
  "linkmanPhone": "", // 联系人电话
  "salaryTop": 4, // 最高薪资 4k
  "jobOrder": "1", // 可选
  "languages": "11", // 语言要求 来自于 dropdown language.id
  "channel": 6, // 代表最佳东方渠道
  "occupation": [
    // 选择单个职能
    "020000", // 该职能的1级职能
    "020200", // 该职能的2级职能
    "020241" // 该职能的3级职能
  ]
}

获取实习僧渠道职能列表

Method：GET
Path：/api/partner/v1/job/occupation/14/{position_id}

{
  "code": 0,
  "message": "success",
  "data": [
    [
      {
        "name": "互联网IT",
        "id": 1,
        "p_id": 0
      },
      {
        "name": "通信/硬件",
        "id": 2,
        "p_id": 0
      }
    ],
    [
      {
        "name": "产品",
        "id": 15,
        "p_id": 1
      },
      {
        "name": "运营",
        "id": 16,
        "p_id": 1
      },
      {
        "name": "技术管理",
        "id": 17,
        "p_id": 1
      }
    ],
    [
      {
        "name": "产品",
        "id": 86,
        "p_id": 15
      },
      {
        "name": "产品经理",
        "id": 87,
        "p_id": 15
      },
      {
        "name": "产品助理",
        "id": 88,
        "p_id": 15
      },
      {
        "name": "产品设计",
        "id": 89,
        "p_id": 15
      }
    ]
  ]
}

获取实习僧渠道下拉枚举值列表

Method：GET
Path：/api/partner/v1/job/dropdown/14/{position_id}

{
  "code": "0",
  "message": "success",
  "data": {
    "intern": {
      "feature": ["班车"],
      "chance": ["entry", "noentry", "notsure"],
      "day_per_week": [1, 2, 3, 4, 5],
      "language": ["english", "chinese", "both", ""],
      "month_num": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
    },
    "is_school": {
      "feature": ["班车"],
      "language": ["english", "chinese", "both", ""],
      "recruitment_target": ["应届生", "毕业1年内"]
    }
  }
}

发布一个职位到实习僧渠道

Method: POST
Path: /api/partner/v1/job/pub/{position_id}

{
  "isSchool": false, // 是否校园招聘
  "features": [
    // 职位的福利， 来自于 dropdown feature 的枚举值
    "五险一金"
  ],
  "language": "chinese", // 语言要求, 来自于 dropdown language 的枚举值
  "dayPerWeek": 5, // 每周实习天数 , 来自于 dropdown day_per_week 的枚举值
  "monthNum": 1, // 实习月数, 来自于 dropdown month_num 的枚举值
  "address": "上海市番禺路1028", // 实习地址 free text
  "chance": "notsure", // 是否有转正机会 , 来自于 dropdown chance 的枚举值
  "effectiveTime": 1788501755025,
  "dailySalaryBottom": "5000", // 最低薪资 元
  "dailySalaryTop": "7000", // 最高薪资 元
  "channel": 14, // 代表实习僧渠道
  "occupation": "后端开发" // 职能 来自于 职能的枚举值
}

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "id": null,
      "channel": 14,
      "status": 3, // status = 1 是代表发布成功
      "title": "软件工程师",
      "account_id": 0,
      "position_id": 20489853,
      "error": "该职位已发布到第三方", // 错误信息 当 status !=1 时候展示
      "create_time": "2026-08-11 16:41:09"
    }
  ]
}

获取职位在渠道的发布记录

Method：GET
Path：/api/partner/v1/job/pub/{position_id}

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "id": 14000,
      "channel": 14,
      "status": 3,
      "title": "软件工程师",
      "account_id": 2742,
      "position_id": "20489853",
      "error": "若您有任何疑问，请联系官方邮箱：sxs@shixiseng.com进行说明，感谢您的理解与支持！",
      "create_time": 1785909843000
    },
    {
      "id": 14005,
      "channel": 6,
      "status": 0,
      "title": "软件工程师",
      "account_id": 2738,
      "position_id": "20489853",
      "error": "work_place 职位不允许发布到该地区",
      "create_time": 1786073762000
    }
  ]
}

51job WIP

从某个渠道撤下职位

Method：PATCH
Path：/api/partner/v1/job/pub/{position_id}

注意:

account_id: /api/partner/v1/job/account/{position_id} 接口返回的ID；
如果使用更新职位状态:PUT /positions/{id}/status接口下架职位，那么所有渠道的职位都将撤下。

{
  "channel": 2, // channel 2 代表猎聘 , 6 代表最佳东方,  1 代表51job ， 14 代表实习僧
  "account_id": 2739
}

不需要 account_id 字段

{
  "channel": 0 // 0 代码从 MoSeeker 撤下 Wechat&Pc门户渠道
}

{
  "code": 0,
  "message": "success"
}