MENU Navbar

MoSeeker Open API Document

Request Address

Environment URL
Production https://openapi.moseeker.com
Test https://openapi-t.dqprism.com

Version

Version Update time
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.4.3 2023-04-13

Overview

Interface Format

The return value of interface is always JSON, which includes 3 fields: "code", "data" and "message"

Field Type Description
code int Status code.
The 0 value means the status is fine, any other value means exceptions.
message string Descriptions for this interface.
data dict Details of the return value.
This field can be empty when an interface is only used to return status.

API Authorization

To start the API authorization, every customer should contact MoSeeker to get app_key and app_secret. The token is generated by app_key and app_secret from this API,and token can be used to authorize customer in other APIs.

Request

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

Response

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

Token

Body Parameters

Key Required Type Description
app_key Yes string unique key for customer
app_secret Yes string secret key

Response data

Key Describe
token token value
expire expire time (hour)

Job Position

Get Positions

Get all the positions for current company.

Get Positions

Headers

Key Required Type Description
token Yes string token

Query Parameters

Key Required Type Description
page_num No integer page number
page_size No integer page size

Response data

Key Describe
id position id
job_number job board postion id
title position title
team position department
cities position city
publish_date position publish date
stop_date position stop date
accountability position description
experience work experience (year)
experience_above work experience (year)
requirement position requirement
language language requirement
update_time position update time
business_group business group
employment_type employment type
hr_email HR email address
degree education degree
degree_above minimum education degree
features position features
email_notice whether to notice HR by email after application or not
candidate_source candidate source
occupation position occupation
is_recom whether to recommendate this position or not
industry company industry
district district of position
count hire count
salary_top maximum salary (k)
salary_bottom minimum salary (k)
management_experience whether management experience is required
gender gender
publisher publisher id
publisher_name publisher name
work_address position work address
is_hiring whether it is a hot hiring position or not
underlings number of underlings
language_required whether a language requirement is a must
target_industry target industry for candidate
is_referral whether candidate is via referral or not
ext position extension data
addresses LBS
top top tag. return true if position with "top" tag, else return false
coordinator_id coordinator HR id
coordinator_name coordinator HR name
custom_fields position custom field information

Response

{
    "code": 0,
    "message": "",
    "data": {
        "total": 44770,
        "page": 1,
        "data": [
            {
                "id": 19551566,
                "job_number": "JOB202003313",
                "title": "title",
                "team": {
                    "id": 188365547,
                    "name": "万达集团/商管集团/酒店管理公司"
                },
                "publish_date": "2020-03-31 18:01:46",
                "stop_date": null,
                "accountability": null,
                "experience": "3",
                "requirement": "position requirement",
                "language": "english",
                "update_time": "2020-03-31 19:21:51",
                "business_group": "",
                "employment_type": 0,
                "hr_email": null,
                "degree": 0,
                "top":false,
                "coordinator_name": "协助HR姓名1,协助HR姓名2",
                "coordinator_id":"111111,222222",              
                "features": [
                    {
                        "id": 119,
                        "company_id": 39978,
                        "name": "feature1",
                        "create_time": "2018-03-06 21:04:10",
                        "update_time": "2019-10-14 17:32:11",
                        "status": "有效"
                    },
                    {
                        "id": 145,
                        "company_id": 39978,
                        "name": "feature2",
                        "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": "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": "address_name",
                        "company_id": 39978,
                        "province": null,
                        "city": 320500,
                        "region": null,
                        "address": "address",
                        "department_id": 0,
                        "department_name": null,
                        "longitude": "116.3974510",
                        "latitude": "39.9091870",
                        "point": null
                    }
                ]
            }
        ],
        "page_size": 1
    }
}

Create Position

Create a new position.

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
job_number Yes string job board position id
title Yes string position title
publisher Yes string publisher id
cities Yes array position cities (less than 10)
requirement Yes string position requirement
accountabilities Yes string position description
process_id Yes integer process id
candidate_source No integer candidate source
employment_type No integer employment type
not_office No integer not office position
salary_top No integer maximum salary (k)
salary_bottom No integer minimum salary (k)
experience No string work experience (year)
language No string language requirement
count No integer hire count (0:no limit)
ext No string position extension
address_id No array LBS
team_id No integer team
job_custom_id No string position custom field
features No array position features
is_referral No integer whether candidate is via referral or not (1: yes, 0: no)
degree No integer degree requirement
top No boolean top tag. return true if position with "top" tag, else return false
coordinator_id No string coordinator HR id
custom_fields position custom field information

Candidate Source

Code Describe
0 Social Recruitment
1 Campus Recruitment

Employment Type

Code Description
0 full-time
1 part-time
2 contractor
3 intern
9 other

Degree Type

Code Describe
0 unlimited
1 junior college
2 Bachelor’s degree
3 Master’s degree
4 MBA
5 PhD
6 Technical secondary school
7 Senior high school
8 PhD or higher
9 Junior high school or lower

Resuest

{
    "job_number":"JOB_NUMBER_0514_1",
    "title":"title",
    "publisher":"82752",
    "cities":[320500],
    "requirement":"requirement",
    "accountabilities":"accountabilities",
    "process_id":1,
    "candidate_source":0,
    "employment_type":0,
    "not_office":0,
    "salary_top":100,
    "salary_bottom":10,
    "experience":"3",
    "language":"english",
    "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": "职位自定义字段三的选项"
        }
    ]
}

Response

{
    "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": "requirement",
        "language": "english",
        "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姓名1,协助HR姓名2", 
        "coordinator_id":"111111,222222", 
        "features": [
            {
                "id": 119,
                "company_id": 39978,
                "name": "feature1",
                "create_time": "2018-03-06 21:04:10",
                "update_time": "2019-10-14 17:32:11",
                "status": "有效"
            },
            {
                "id": 145,
                "company_id": 39978,
                "name": "feature2",
                "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": "address_name",
                "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
            }
        ]
    }
}

Update Position

Update the existing positions.

Headers

Key Required Type Description
token Yes string token

Path Parameters

Key Required Type Description
id Yes number position id

Body Parameters

Key Required Type Description
title Yes string position title
publisher Yes string publisher id
cities Yes array position cities (less than 10)
requirement Yes string position requirement
accountabilities Yes string position description
candidate_source No integer candidate source
employment_type No integer employment type
not_office No integer not office position
salary_top No integer maximum salary (k)
salary_bottom No integer minimum salary (k)
experience No string work experience (year)
language No string language requirement
count No integer hire count (0:no limit)
ext No string position extension
address_id No array LBS
team_id No integer team
job_custom_id No string position custom field
features No array position features
is_referral No integer whether candidate is via referral or not (1: yes, 0: no)
degree No integer degree requirement
top No boolean top tag. return true if position with "top" tag, else return false
coordinator_id No string coordinator HR id
custom_fields position custom field information

Request

{
    "title":"title",
    "requirement":"requirement",
    "accountabilities":"accountabilities",
    "experience":"3",
    "language":"english",
    "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":"122232",
    "custom_fields": [
        {
            "config_type": 1,
            "value": "职位自定义字段下的选项"
        },
        {
            "config_type": 2,
            "value": "职位自定义字段二的选项"
        },
        {
            "config_type": 3,
            "value": "职位自定义字段三的选项"
        }
    ]    
}

Response

{
    "code": 0,
    "message": "",
    "data": {
        "id": 19551603,
        "job_number": "JOB20200402_5",
        "title": "title",
        "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": "requirement",
        "language": "english",
        "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": "feature1",
                "create_time": "2018-03-06 21:04:10",
                "update_time": "2019-10-14 17:32:11",
                "status": "有效"
            },
            {
                "id": 145,
                "company_id": 39978,
                "name": "feature2",
                "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姓名", 
        "coordinator_id":"1000211", 
        "ext_vo": {
            "job_custom_id": 0,
            "create_time": "1585800261000",
            "update_time": "1585800261000",
            "job_occupation_id": 0,
            "pid": 19551603,
            "extra": null,
            "ext": "ext3"
        },

        "addresses": [
            {
                "id": 1,
                "address_name": "address_name",
                "company_id": 39978,
                "province": null,
                "city": 320500,
                "region": null,
                "address": "address",
                "department_id": 0,
                "department_name": null,
                "longitude": "116.3974510",
                "latitude": "39.9091870",
                "point": null
            }
        ]
    }
}

Update Position Status

Acitvate or In-activate the position.

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
hr_id Yes string publisher id
status Yes integer position status

职位状态

Code Description
0 active
2 inactive

Response data

Key Describe
amount updated position amounts

Request

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

Response

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

Get Position Custom List

Get all the positions custom for current company.

Get Position Custom

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id custom id
status custom ststus
name custom name

Response

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

Get Position Feature List

Get all the positions features for current company.

Get Position Features

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id feature id
company_id company id
name feature name
create_time feature create time
update_time feature update time
status feature status

Response

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

Get Position Publisher List

Get all the positions publisher for current company.

Get Position Publisher

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id publisher id
company_id company id
mobile publisher mobile
email publisher email
user_name publisher name
create_time publisher create time
update_time publisher update time
status publisher status

Response

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 82752,
            "mobile": "15000000000",
            "email": "publisher1@moseeker.com",
            "user_name": "publisher1",
            "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": "publisher2",
            "create_time": "2016-08-01 15:17:19",
            "update_time": "2020-04-16 13:36:09",
            "status": "有效"
        }
    ]
}

link positions to application form

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
from_id Yes string form id
position_ids Yes array position id list, eg. [1,2,3,4,5].

Request

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

Response

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

Application

Get Applications

This interface is used to get applications in MoSeeker.

Headers

Key Required Type Description
token Yes string token

Query Parameters

Key Required Type Description
ats_status No string application status
stage_id No integer stage id
page_num No integer page number
page_size No integer page size
start_time No string application start time('%Y-%m-%d %H:%M:%S')
end_time No string application end time('%Y-%m-%d %H:%M:%S')

Application Status

Code Describe
1 synchronization failed
3 synchronization success

Response data

Key Describe
id application id
position_id position id
process_id process id
stage_id stage id
name candidate name
gender_name gender
head_img headshot photo
city_code city code
nationality_name nationality
current_job current job
city_name city
constellation constellation
country_code country code
email email address
qq QQ id
mobile mobile number
birth birth date
self_introduction self introduction
motto motto
source_name application source
languages languages
> level language certification level
> name language certification name
credentials credentials
> score credential score
> organization organization of credential
> name credential description
educations educations
> start_date start date
> end_date end date
> end_until_now education in progress
> degree_name degree
> college_name college name
> country_name coutry name of college
> major_name major
> description description of major
workexps work experience
> start_date start date
> end_date end date
> end_until_now work in progress
> company_scale_name company scale
> department_name department name
> job job name
> position_code position code
> position_name position name
> achievement achievement
> company_name company name
> description description
awards awards
skills skills
> name skill name
> level skill level
projectexps project experience
> start_date start date
> end_date end date
> end_until_now project in progress
> name project name
> role role in project
> company_name company name
> achievement achievement in project
> responsibility responsibility in project
> description project description
intentions intentions
> work_state_name work state
> salary_code_name expect salary
> consider_venture_company_opportunities whether consider venture company opportunities
> work_type_name work type
> cities work cities
> > city_name city name
> > city_code city code
> positions expect positions
> > position_code position code
> > position_name position name
> industries industries
> > industry_name industry name
> > industry_code industry code
referral referral
> name referral's name
> mobile referral's mobile
> email referral's email
> ext referral's other infomation. If HR record the employee number into the system for "Employee Certification", "ext" will be the "Employee Number"

Response

{
    "code": 0,
    "message": "",
    "data": {
        "total": 7,
        "page": 2,
        "data": [
            {
                "id": 2698479,
                "position_id": 19530149,
                "process_id": 0,
                "stage_id": 0,
                "name": "name",
                "gender_name": "man",
                "head_img": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTJ7qCurHcjRLmomBNLVSs43XlRxM9mXciaribEIhGoBxumyeh014zaOicBOraAcoJV3pFkMyBCt8ZcWg/132",
                "city_code": 310000,
                "nationality_name": "China",
                "current_job": "software testing engineer",
                "city_name": "Shanghai",
                "constellation": "Taurus",
                "country_code": "86",
                "email": "123@qq.com",
                "qq": "",
                "mobile": "15998601386",
                "birth": "1994-05-01",
                "self_introduction": "***",
                "motto": "",
                "source_name": null,
                "languages": [
                    {
                        "level": 2,
                        "name": "English"
                    }
                ],
                "credentials": [
                    {
                        "score": "",
                        "organization": "",
                        "name": "CET"
                    }
                ],
                "educations": [
                    {
                        "start_date": "2018-01-01",
                        "end_date": null,
                        "end_until_now": 1,
                        "degree_name": "Technical secondary school",
                        "college_name": "Can Tho University",
                        "country_name": "Socialist Republic of Vietnam",
                        "major_name": "Applied psychology",
                        "description": ""
                    }
                ],
                "workexps": [
                    {
                        "start_date": "2015-07-01",
                        "end_date": "2019-09-09",
                        "end_until_now": 1,
                        "company_scale_name": "company_scale_name",
                        "department_name": "111",
                        "job": "software testing engineer",
                        "position_code": 0,
                        "position_name": "",
                        "achievement": "",
                        "company_name": "ISoftStone Information Technology (Group) Co., Ltd.",
                        "description": "Ensure the quality of development software, test process control, write test cases, and track bugs"
                    }                ],
                "awards": [],
                "skills": [
                    {
                        "name": "python",
                        "level": 1
                    }
                ],
                "projectexps": [
                    {
                        "start_date": "2015-09-01",
                        "end_date": "2017-02-01",
                        "end_until_now": 0,
                        "name": "APP test",
                        "role": "",
                        "company_name": "",
                        "achievement": "",
                        "responsibility": "",
                        "description": "Project description: \nTest project process review, iterative project quality control, evaluation test time, test case rationality, etc. \n \nProject responsibilities: \nfd"
                    }
                ],
                "intentions": [
                    {
                        "work_state_name": "",
                        "salary_code_name": "25k",
                        "consider_venture_company_opportunities": "",
                        "work_type_name": "part time",
                        "cities": [
                            {
                                "city_name": "Shanghai",
                                "city_code": 310000
                            }
                        ],
                        "positions": [
                            {
                                "position_code": 180300,
                                "position_name": "Project management / project coordination"
                            }
                        ],
                        "industries": [
                            {
                                "industry_name": "Internet / electric business operations",
                                "industry_code": 0
                            }
                        ]
                    }
                ],
                "referral": {
                    "name": "name",
                    "mobile": "15000869284",
                    "email": "247334622@qq.com",
                    "ext": "ER0001"
                }
            }
        ],
        "page_size": 1
    }
}

Get Application Attachment

This interface is used to get one application attachment.

Headers

Key Required Type Description
token Yes string token

Path Parameters

Key Required Type Description
id Yes number application id

Response data

Key Describe
type type
content resume (base64)
profile_content When the original resume is null, please take the standard resume attachment(base64)
profile_type corresponding document type of profileContent(support pdf,docx)
profile_name corresponding document name of profileContent

Response

{
    "code": 0,
    "message": "",
    "data": {
        "type": "pdf",
        "content": "****",
        "profile_content": "****",
        "profile_type": "pdf",
        "profile_name": "test.pdf"
    }
}

Update Application Status

This interface is used to update application status in MoSeeker. You can only update the status to 3 (i.e. update it to success) now.

Headers

Key Required Type Description
token Yes string token

Path Parameters

Key Required Type Description
id Yes number application id

Body Parameters

Key Required Type Description
ats_status Yes string update status (3: update succssful)

Response data

Key Describe
amount amount of successfully updated applications

Request

{
    "ats_status": 3
}

Response

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

Update Application Process

This interface is used to update application process in MoSeeker.

Archiving, elimination, on board need to call other interface "pigeonhole".

Headers

Key Required Type Description
token Yes string token

Path Parameters

Key Required Type Description
id Yes number application id

Body Parameters

Key Required Type Description
hr_id Yes integer HR id
stage_id Yes integer stage id

Response data

Key Describe
amount amount of successfully updated processes.

Request

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

Response

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

Get Application CV

This interface is used to get application CV in MoSeeker.

Headers

Key Required Type Description
token Yes string Token

Query Parameters

Key Required Type Description
page_num No integer page number
page_size No integer count
stage_id No integer stage ID
start_time No string application start time('%Y-%m-%d %H:%M:%S')
end_time No string application end time('%Y-%m-%d %H:%M:%S')

Response data

Key Describe
id application id
candidate_profile_id candidate profile id
candidate_source candidate source from
company_id_id company id
job_number third position id
l_application_id ATS application ID
origin application source from
position_id position ID
profile_id profile ID
stage_id stage ID
submit_time submit time
user_id user ID
awards awards
> name award name
> time award time
basic QQ
> credentials_number credential number
> credentials_type credential type
>> code credential code
>> name credential name
> nationality nationality
>> code country code
>> name country name
> recent_company recent company
> recent_work recent work
> salary recent salary
> self_description self description
> certificates certificates
>> code certificate number
>> get_date get date
>> name certificate name
>> organization organization
>> score score
>> url url
educations educations
> college college
>> code college code
>> name college name
> degree degree
> description description
> start_time start time
> end_time end time
> end_until_now until now
> gpa GPA
> major major
intention intentions
> cities expected working city
>> name city name
>> code city code
> expected_salary expected salary
> industries expected industries
>> name industry name
>> code industry code
> positions expected positions
>> name position name
>> code position code
> work_state work state
>> name state name
>> code state code
> work_type work type
>> name type name
>> code type code
languages languages
> level language level
> name language description
overview overview
> age age
> area_code area code
> birth birthday
> city current city
>> name city name
>> code city code
> country_code country code
> degree top degree
> email email
> gender gender
>> code gender code
>> name gender name
> mobile phone number
> name name
> qq QQ
> wechat wechat
> wechat_avatar wechat avatar
> work_years years of work
project_experiences project experience
> start_time start time
> end_time end time
> end_until_now until now
> name project name
> role role
> company company name
> responsibility responsibility
> description project description
skills skills
> name skill name
> level skill level
work_experiences work experience
> start_time start time
> end_time end time
> end_until_now until noe
> department department
> job job content
> company company
> description job description
works personal works
> cover work cover
> url work url
> description work description
referral referral
> name referral's name
> mobile referral's mobile
> email referral's email
> ext referral's other infomation. If HR record the employee number into the system for "Employee Certification", "ext" will be the "Employee Number"
form_group custom fields
> group_id group_id
> group_title_zh module Chinese name
> group_title_en module English name
> form_field_lists custom fields under module
>> form_field_vo custom fields under module
>>> field_id field id
>>> field_title_zh field Chinese name
>>> field_title_en field English name
>>> string_value value
>>> string_value_enum enum value
>>>> name enum name
>>>> code enum code
>>> multi_value multiple selection value
>>> multi_value_enum multiple selection enum value
>>> time_value time value
>>>> start_time start time
>>>> end_time end time
>>>> end_until_now up to now

Response

{
    "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": "CET 4",
                "time": "2020-09-16"
              }
            ],
            "basic": {
              "credentials_number": "32154252641642132",
              "credentials_type": {
                "code": "1",
                "name": "ID card"
              },
              "nationality": {
                "code": "86",
                "name": "china"
              },
              "recent_company": "daqi technology",
              "recentWork": "soft engineer",
              "salary": "15000",
              "self_description": "cheerful"
            },
            "certificates": [
              {
                "code": "21563366",
                "get_date": "2020-09-16 08:23:38",
                "name": "Blue Bridge Cup National Second Prize",
                "organization": "Blue Bridge Cup",
                "score": "99",
                "url": ""
              }
            ],
            "educations": [
              {
                "college": {
                  "code": "66",
                  "name": "Nanjing University of Aeronautics and Astronautics(NUAA)"
                },
                "degree": {
                  "code": "1",
                  "name": "master's degree"
                },
                "description": "one",
                "end_time": "2020-06-15",
                "end_until_now": 0,
                "gpa": 0,
                "major": {
                  "code": "1",
                  "name": "software engineering"
                },
                "start_time": "2013-09-13"
              }
            ],
            "intention": {
              "cities": [
                {
                  "code": "65",
                  "name": "Shanghai"
                }
              ],
              "expected_salary": "20000",
              "industries": [
                {
                  "code": "22",
                  "name": "internet"
                }
              ],
              "positions": [
                {
                  "code": "45",
                  "name": "software"
                }
              ],
              "work_state": {
                "code": "22",
                "name": "on the job"
              },
              "work_type": {
                "code": "22",
                "name": "full time"
              }
            },
            "languages": [
              {
                "level": "1",
                "name": "english"
              }
            ],
            "overview": {
              "age": 0,
              "area_code": "string",
              "birth": "string",
              "city": {
                "code": "22",
                "name": "Shanghai"
              },
              "country_code": "86",
              "degree": 1,
              "email": "123@123.com",
              "gender": {
                "code": 1,
                "name": "female"
              },
              "mobile": "15266699978",
              "name": "Lily",
              "qq": "123456789",
              "wechat": "121212",
              "wechat_avatar": "",
              "work_years": 1
            },
            "project_experiences": [
              {
                "company": "daqi",
                "description": "Manufacturing Saas",
                "end_time": "2012-02-12",
                "end_until_now": 0,
                "name": "Manufacturing Saas System",
                "responsability": "Business development",
                "role": "master",
                "start_time": "2019-02-12"
              }
            ],
            "skills": [
              {
                "level": 0,
                "name": "Linux"
              }
            ],
            "work_experiences": [
              {
                "company": "dqi",
                "department": "engineering",
                "description": "Business development",
                "end_time": "2020-03-15",
                "end_until_now": 0,
                "job": "software engineer",
                "start_time": "2019-02-12"
              }
            ],
            "works": [
              {
                "cover": "no",
                "description": "no",
                "url": "no"
              }
            ],
            "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
    }
}

pigeonhole

pigeonhole

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
candidate_ids Yes array[integer] application id array
hr_id Yes integer HR's ID
type Yes integer operation type
description Yes string operation introductions

operation type

Code Describe
1 on board
2 declined the job
3 candidate eliminated

Response data

Key Describe

Request

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

Response

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

Application Form

Get Application Forms

Obtain all application forms under the company

Get Application Forms

Headers

Key Required Type Description
token Yes string token

Query Parameters

Key Required Type Description
page_num No integer page number
page_size No integer page size

Response data

Key Describe
id id
title chinese name
title_en english name
description chinese description
description_en english description

Response

{
    "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
    }
}

Process

Get Process

This interface is used to get all processes for current company. Every position should be assigned to a process in order to distinguish different stages during application process.

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id process id
name process name
description process description
position_num position number
stage_num stage number

Response

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "process name",
            "description": "description",
            "position_num": 10,
            "stage_num": 5
        }
    ]
}

Get Process Stages

This interface is used to obtain the stage information under the corresponding process.

Headers

Key Required Type Description
token Yes string token

Path Parameters

Key Required Type Description
id Yes number process id

Response data

Key Describe
id stage id
name stage name
order stage order

Response

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 225,
            "name": "Preliminary screening",
            "order": 1
        },
        {
            "id": 267,
            "name": "Initial",
            "order": 2
        }
    ]
}

Address

Get LBS

A location-based service (LBS) is a general term denoting software services which utilize geographic data and information to provide services or information to users. LBS can be used in a variety of contexts, such as health, indoor object search, entertainment, work, personal life, etc.

Get all the positions LBS for current company. LBS is the specific address display of the MoSeeker job details page to implement map navigation of the address.

Get LBS Address

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id address id
address_name address name
province address province
city address city
region address region
address address detail
longitude longitude
latitude latitude

Response

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 1,
            "address_name": "address_name",
            "province": 320000,
            "city": 320200,
            "region": 320203,
            "address": "address1",
            "longitude": "117.0663820",
            "latitude": "36.6880690"
        },
        {
            "id": 2,
            "address_name": "address_name2",
            "province": 650000,
            "city": 650100,
            "region": 650103,
            "address": "Wuhan",
            "longitude": "121.0000000",
            "latitude": "31.0000000"
        }    
    ]
}

Create LBS

Create a new LBS.

Create LBS Address

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
address Yes string address detail
address_name Yes string address name
city Yes integer address city
latitude No float latitude
longitude No float longitude

Request

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

Response

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

Update LBS

Update LBS by id.

Update LBS Address

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
address Yes string address detail
address_name Yes string address name
city Yes integer address city
latitude Yes float latitude
longitude Yes float longitude

Request

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

Response

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

Team

Get Team

Get all the team for current company.

Get Team

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id team id
name team name
description team description

Response

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

Get Nested Team

Get all the team for current company's hr with nested structures.

Get Organizational Tree

Headers

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

Response data

Key Describe
id team id
name name
parent_id parent id
type type
type_label type label
children sub teams

Response

{
    "code": 0,
    "message": "",
    "data": [
        {
            "children": [
                {
                    "children": [],
                    "company_id": 39978,
                    "name": "accountant",
                    "parent_id": 188373785,
                    "id": 188373773,
                    "type": 2,
                    "type_label": "department"
                }
            ],
            "company_id": 39978,
            "name": "Finance",
            "parent_id": 0,
            "id": 188373785,
            "type": 2,
            "type_label": "org"
        }
    ]
}

Accounts

Get HR Account

Get all the HR account for current company.

Get HR Account

Headers

Key Required Type Description
token Yes string token

Response data

Key Describe
id publisher id
company_id company id
mobile publisher mobile
email publisher email
user_name publisher name
create_time publisher create time
update_time publisher update time
status publisher status

Response

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 82752,
            "mobile": "15000000000",
            "email": "publisher1@moseeker.com",
            "user_name": "publisher1",
            "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": "publisher2",
            "create_time": "2016-08-01 15:17:19",
            "update_time": "2020-04-16 13:36:09",
            "status": "有效"
        }
    ]
}

Create Account

Create a new Account

Create HR Account

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
role_type Yes integer Role type 1: Super administrator 2: Administrator 3: HR 4: Senior employment manager 5: Employment manager 6: Interviewer
user_name Yes string user name
mobile Yes string mobile
email Yes string email
deparment_name No string Organization name,When the role type is Administrator or HR, deparment_name cannot be set
managed_department_name No string Responsible for the name of the organization.When the role type is Administrator or HR, the managed_department_name must be set. When the role type is senior employing manager, employing manager, interviewer, the managed_department_name cannot be set.Multiple names are separated by comma
job_number No string job number

Request

{
    "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 Response code, 0 means success
message Response message
data Response data

Response

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

Update Account

Update HR Account

Update HR Account

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
role_type Yes integer Role type 1: Super administrator 2: Administrator 3: HR 4: Senior employment manager 5: Employment manager 6: Interviewer
user_name Yes string user name
mobile Yes string mobile
email Yes string email
deparment_name No string Organization name,When the role type is Administrator or HR, deparment_name cannot be set
managed_department_name No string Responsible for the name of the organization.When the role type is Administrator or HR, the managed_department_name must be set. When the role type is senior employing manager, employing manager, interviewer, the managed_department_name cannot be set.Multiple names are separated by comma
job_number No string job number
update_type Yes integer 0:update by mobile 1:update by job number

Request

{
    "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 Response code, 0 means success
message Response message
data Response data

Response

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

Disable Account

Disable HR account, fill in at least one of mobile and job number.

Disable HR Account

Headers

Key Required Type Description
token Yes string token

Body Parameters

Key Required Type Description
mobile Yes string mobile
job_number No string job number
update_type Yes integer 0:update by mobile 1:update by job number

Request

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

Response data

Key Describe
code Response code, 0 means success
message Response message
data Response data

Response

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

Get Account By Role

Get account by role

Get HR Account by role

Headers

Key Required Type Description
token Yes string 令牌

Body Parameters

Key Required Type Description
role_type Yes string Multiple roles are separated by commas. Role type 1: Super administrator 2: Administrator 3: HR 4: Senior employment manager 5: Employment manager 6: Interviewer

Response data

Key Describe
code Response code, 0 means success
message Response message
data Response data.Group by role, each group is all accounts under that role

Response

{
    "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"
                }]
            }
}

Dictionary

City

Headers

Key Required Type Description
token Yes string token

Response

{
    "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
            }
        ]
    }
}

WeChat

Official Accounts access_token

Please provide the caller's IP address, MoSeeker needs to configure it into the whitelist

Headers

Key Required Type Description
token Yes string token

Response

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

中文版

OPEN-API