岗位职级查询¶
获取岗位职级列表¶
使用场景:该接口用于获取全部岗位职级的列表。
请求方式:GET(HTTPS)
请求地址:https://openapi.2haohr.com/api/job_levels/?access_token=ACCESS_TOKEN
参数说明:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
access_token | String | 是 | 调用接口凭证 |
limit | String | 否 | 每页大小,[0,100] ,默认20 |
p | String | 否 | 查询页码 |
ids | String | 否 | 职级id,使用逗号隔开,一次最多支持100,如果不写,获取所有的职级列表 |
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "",
"data":{
"p": 1,
"limit": 20,
"offset": 0,
"total_count": 10,
"totalpage": 1,
"objects": [{
"id": "9faec9******d4c959d8af*****8c2bd5",
"name": "P5-1",
"title": "高级工程师",
"job_level_group_name": "P5",
"job_level_group_title": "高级工程师",
"job_level_channel_id": "4eca7f******45898d0b******331a41",
"job_level_channel_name": "管理通道"
}
]
}
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
p | 页码 |
limit | 每页大小 |
total_count | 总计 |
totalpage | 总页数 |
objects | 职级列表 |
data | 返回数据 |
id | 职级id |
name | 职级编号 |
title | 职级名称 |
job_level_group_name | 职级分组编号 |
job_level_group_title | 职级分组名称 |
job_level_channel_id | 职级通道id |
job_level_channel_name | 职级通道名称 |
获取岗位职级的员工数量¶
使用场景:该接口用于获取具体岗位职级的员工数量,最多一次可获取100个岗位职级。
请求方式:GET(HTTPS)
请求地址:https://openapi.2haohr.com/api/job_levels/employee_count/?access_token=ACCESS_TOKEN&ids=IDS
参数说明:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
access_token | String | 是 | 调用接口凭证 |
ids | String | 是 | 岗位职级id集合,用英文逗号分隔 |
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "",
"data": [{
"id": "6c1252*****843388759d*****68494f",
"count": 10
}]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
data | 返回数据 |
id | 职级id |
count | 员工数 |
获取公司职级列表¶
使用场景:该接口拉取公司所有的职级列表信息,也可单独获取某个职级通道的职级信息。
请求方式:GET(HTTPS)
请求地址:https://openapi.2haohr.com/api/job_level/list/?access_token=ACCESS_TOKEN
参数说明:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
access_token | String | 是 | 调用接口凭证 |
channel_id | String | 否 | 通道id |
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "",
"data":[{
"id": "9faec9******d4c959d8af*****8c2bd5",
"name": "P6-1",
"title": "初级软件工程师",
"job_level_group_name": "P6",
"job_level_group_id": "2c45******c04e869b5e9f7******afa",
"job_level_channel_id": "4eca7f******45898d0b******331a41",
"job_level_channel_name": "技术通道",
"grade": "职等",
"desc": "职级描述"
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
data | 返回数据 |
id | 职级id |
name | 职级编号 |
title | 职级名称 |
job_level_group_name | 职级分组编号 |
job_level_group_id | 职级分组id |
job_level_channel_id | 职级通道id, 为空标识默认职级通道 |
job_level_channel_name | 职级通道名称 |
grade | 职等 |
desc | 职级描述 |