岗位职级查询

获取岗位职级列表


使用场景:该接口用于获取全部岗位职级的列表。

请求方式: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 职级描述