根据部门获取职位清单

最后更新于:2019-11-12 22:09:50

可通过本接口来获取某部门下职位清单

接口调用请求说明

https请求方式:GET

请求地址:https://openapi.ihr360.com/openapi/organization-api/position/getPositionByDepartmentId/{departmentId}

例如,返回部门Id为"0"的职位清单时

地址为:https://openapi.ihr360.com/openapi/organization-api/position/getPositionByDepartmentId/0

调用前,在请求头信息中必须包含以下2项

Content-Type:application/json;charset=UTF-8

Authorization: Bearer access_token;

例如,获取到的有效凭证为8f87b9b1-9f66-4b32-9269-0d41a0face00,则头信息中数据应为:

Content-Type:application/json;charset=UTF-8

Authorization: Bearer 8f87b9b1-9f66-4b32-9269-0d41a0face00。

返回说明 正常情况下,"i人事"会返

回如下JSON数据给第三方:

返回数据说明

属性 类型 说明
code Int 错误代码,成功是为0
message String 错误消息,成功时为"ok"或者为"SUCCESS"
url String 请求URL
data JSONArray 拉取到根据部门获取的职位清单
errorResult Boolean 错误时为true

职位属性说明

属性 类型 说明
id String 职位ID
positionName String 职位名称
positionCode String 职位编号
appliedRange enum(枚举) 应用范围(CURRENT_DEPARTMENT:当前部门,CURRENT_DEPARTMENT_AND_CHILDREN:包含子部门)
capacity Integer 当前编制人数
departmentId Long 所属部门Id
description Integer 职位描述
jobTitleIdString对应职务id
positionGradeIdString对应职级id
qualificationsString任职资格

错误时,"i人事"会返回错误码等信息,JSON数据包示例如下(该示例以APPID无效错误):

{

"code":0,

"message":null,

"url":null,

"data":[{"id":"00198519-a51b-4b38-b1e7-a62a73b875ef","positionName":"培推专员","positionCode":null,"appliedRange":"CURRENT_DEPARTMENT_AND_CHILDREN","capacity":0,"departmentId":203,"description":null,"departmentName":null,"jobTitleId":null,"jobTitleName":null,"positionGradeId":null,"positionGradeName":null,"qualifications":null}],

"showType":0,

"errorResult":false

}