岗位信息 - 2号人事部开放平台

岗位信息¶

岗位新增¶

使用场景：该接口用于新增岗位。

请求方式：POST（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/create/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
name	String	是	岗位名称, 不能重复, 长度限制为1~100个字符
code	String	否	岗位编码, 长度限制为1~20个字符
department_id	String	否	所属组织ID
job_group_id	String	否	岗位类别ID

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
       "id": ""
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据
id	岗位id

岗位更新¶

使用场景：该接口用于更新岗位。

请求方式：POST（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/update/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
id	String	是	岗位id
name	String	是	岗位名称, 不能重复, 长度限制为1~100个字符
code	String	否	岗位编码, 长度限制为1~20个字符
department_id	String	否	所属组织ID
job_group_id	String	否	岗位类别ID

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
       "success": true, 
       "msg": "更新成功"
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据

查找岗位¶

使用场景：通过岗位名称、岗位编码，获取岗位id等基本信息。

请求方式：GET（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_title/paged_list/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
keyword	String	否	查找关键字（岗位名称、岗位编码）
limit	String	否	每页返回数据量
p	String	否	页码

权限说明

返回结果：

{
  "data": {
    "p": 1,
    "limit": 20,
    "offset": 0,
    "total_count": 1,
    "totalpage": 1,
    "objects": [
             {
            "sort_text": "000600000000",
            "job_level_top_id": null,
            "default_job_level_id": null,
            "manning": null,
            "job_title_number": "",
            "id": "0260****-9be7-****-8e24-b3257efc****",
            "dep_set": [],
            "add_dt": 1630377430000,
            "over_count": 0,
            "onleave_emp_count": 0,
            "department_id": null,
            "status": 1,
            "is_tooltips": false,
            "departing_emp_count": 0,
            "intent_emp_count": 0,
            "job_title_group_fullname": "未分类",
            "open_date": "2021-08-11",
            "full_emp_count": 2,
            "job_level_floor_id": null,
            "sub_emp_count": 1,
            "name": "产品经理",
            "department_name": "",
            "current_emp_count": 9,
            "job_level_type": 1,
            "job_title_group_id": null,
            "lack_count": 0
        }
    ]
  },
  "errcode": 0,
  "errmsg": ""
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据
object	返回主体数据
p	页码，默认1
limit	每页返回数据量，默认20
offset	偏移量
total_count	返回总数量
totalpage	总页数
sort_text	排序值
job_level_top_id	岗位职级上限
default_job_level_id	默认岗位职级ID
manning	编制人数
job_title_number	岗位编码
id	岗位ID
dep_set	部门集合
add_dt	添加时间
over_count	超编人数
onleave_emp_count	待离职人数
department_id	部门ID
status	状态
is_tooltips	职级范围是否显示提示
departing_emp_count	离职员工人数
intent_emp_count	待入职员工人数
job_title_group_fullname	岗位类别
open_date	启用日期
full_emp_count	全职员工数
job_level_floor_id	岗位职级下限
sub_emp_count	下属员工人数
name	岗位名称
department_name	部门名称
current_emp_count	当前员工人数
job_level_type	岗位职级类别
job_title_group_id	上级岗位类别Id
lack_count	缺编人数

获取岗位类别列表¶

使用场景：该接口用于获取岗位类别信息。

请求方式：GET（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_group/list/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
id	String	否	岗位类别id, 获取指定岗位类别及其子类别。如果不填，默认获取全部类别

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": [{
            "code": "0001",
            "title": "营销类",
            "parentid": "",
            "id": "a149cc*****14b32990c8*****b420ef",
            "children": [
                {
                    "code": "",
                    "title": "业务类",
                    "parentid": "a149cc*****14b32990c8*****b420ef",
                    "id": "bx33fg*****17b081bfd8*****c51c8e8a",
                    "children": [
                    ]
                }
            ]
        }]
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据列表
code	岗位类别编码
title	岗位类别名称
parentid	父级类别id
id	类别id
children	直属子类别列表

获取全部岗位列表¶

使用场景：该接口用于获取所有岗位名称列表。

请求方式：GET（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
limit	String	否	每页大小，[0,100] ,默认20
p	String	否	查询页码

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
       "p": 1,
       "limit": 20,
       "total_count": 11,
       "totalpage": 1,
       "objects": [{
           "id": "7d1d6c*****34641839e0*****0958c9",
           "name": "电气主管",
           "code": "DQ-QM-001",
           "job_group_id": "",
           "department_id": "",
           "status": 1
        }]
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据
p	页码
limit	每页大小
total_count	总计
totalpage	总页数
objects	列表数据
id	岗位id
name	岗位名称
code	岗位编码
job_group_id	岗位类别ID
department_id	所属组织ID
status	岗位状态 1-使用中 2-已停用

获取岗位的员工数量¶

使用场景：该接口用于获取指定岗位的员工数量，最多一次可获取100个岗位。

请求方式：GET（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/employee_count/?access_token=ACCESS_TOKEN&ids=

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
ids	String	是	岗位id集合，用英文逗号分隔

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": [{
        "id": "7d1d6c*****34641839e0*****0958c9",
        "count": 10
    }]
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据
id	岗位id
count	员工数

获取职务列表¶

使用场景：该接口用于获取职务列表。

请求方式：GET（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_title/list/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
p	Int	否	分页页码
limit	Int	否	分页数量，范围为1～100

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
      "p": 1,
      "limit": 20,
      "total_count": 11,
      "totalpage": 1,
      "objects": [{
          "competence": "",
          "description": "",
          "code": "**",
          "id": "72fcaf******48eaa0ab68775e******899577",
          "name": "**"
      }]
   }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据
p	页码
limit	每页大小
total_count	总计
totalpage	总页数
objects	列表数据
id	职务id
name	职务名称
code	职务编码
description	职务描述
competence	能力要求

添加职务¶

使用场景：该接口用于添加职务。

请求方式：POST（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_title/create/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
name	String	是	职务名称, 不能重复，长度限制为1~100个字符
code	String	否	职务编码，长度限制为1~15个字符
description	String	否	职务描述，长度限制为1~1000个字符
competence	String	否	能力要求，长度限制为1~1000个字符

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
        "id": "72fcaf******48eaa0ab68775e******899577"
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据
id	职务id

更新职务¶

使用场景：该接口用于更新职务。

请求方式：POST（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_title/update/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
id	String	是	职务id
name	String	是	职务名称, 不能重复，长度限制为1~100个字符
code	String	否	职务编码，长度限制为1~15个字符
description	String	否	职务描述，长度限制为1~1000个字符
competence	String	否	能力要求，长度限制为1~1000个字符

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
        "success": true, 
        "msg": "更新成功"
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据

启用岗位¶

使用场景：该接口用于启用岗位。

请求方式：POST（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_title/re_enable/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
id	String	是	岗位id
open_date	String	是	启用日期，只能为当天
name	String	是	岗位名称, 不能重复，长度限制为1~100个字符
job_title_number	String	否	岗位编码，长度限制为1~20个字符
job_title_group_id	String	否	岗位类别

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
        "success": true, 
        "msg": "更新成功"
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据

停用岗位¶

使用场景：该接口用于停用岗位。

请求方式：POST（HTTPS）

请求地址：https://openapi.2haohr.com/api/job_positions/job_title/disable/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
close_date	String	是	停用日期，必须介于启用日期与当天之间
id	String	是	岗位id
close_reason	String	否	停用原因，长度限制为1~100个字符

权限说明

返回结果：

{
   "errcode": 0,
   "errmsg": "",
   "data": {
        "success": true, 
        "msg": "更新成功"
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
data	返回数据

Keys	Action
`?`	Open this help
`n`	Next page
`p`	Previous page
`s`	Search