岗位信息 - 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	返回数据

获取岗位类别列表¶

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

请求方式：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	返回数据

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