查询当前部门所有父部门


根据部门ID获取当前部门的所有上级父部门信息。如三级部门C的上级部门为二级部门B和一级部门A,则部门id输入C,返回所有上级父部门路径A>>B>>C。

请求格式说明

请求方式: GET (HTTPS)

请求地址: https://open.welink.huaweicloud.com/api/contact/v1/department/parent

认证方式: access_token,请参考获取access_token

请求头部:

Accept-Charset:UTF-8
Content-Type:application/json
x-wlk-Authorization:access_token

请求参数说明:

参数名 参数说明 类型 必选
deptCode 部门编码。从用户详细信息中获取部门编码。 string

请求示例:


curl -X GET "https://open.welink.huaweicloud.com/api/contact/v1/department/parent?deptCode=2000" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"

响应格式说明

正常返回结果:

  {
    "code": 0,
    "message": "OK",
    "data": [
      {
        "deptAllCode": "1003>>2003>>3003",                           //所有上级部门Id, 必填
        "deptAllNameCn": "一级部门>>二级部门>>测试本部门",             //所有上级部门中文名称
        "deptAllNameEn": "1stDeptName>>2ndDeptName>>TestDeptName"  //所有上级部门英文名称
      }
    ]
  }

异常返回结果

  {
    "code": 47101,
    "message": "Token格式错误",
    "data": []
  }

返回参数说明:

参数名 必选 类型 参数说明
code int 数据正常返回“0”,如果发生错误,会返回对应的错误码
message string 返回信息,包括接口请求发生错误时的详细信息
data array 部门路径信息:
>> deptAllCode: 部门路径编码
>> deptAllNameCn: 部门路径中文名称
>> deptAllNameEn: 部门路径英文名称

错误码说明:

错误码 说明
47000 无权限
47001 当前登录用户信息获取失败
47002 部门编码为空
47003 参数为空
47004 参数不对
47007 当前登录者是非法用户或个人详情已失效
47008 参数校验不通过
47009 提交失败
47012 无数据
47013 查询数量限制
47100 待处理
47101 Token格式错误
47102 无权限
47103 Token过期
47104 处理中
47105 秘书账号未创建
47106 上级部门未创建
500 系统错误

result. ""

    Not Found. ""