查询指定用户部门所有父部门


根据用户信息(userId、corpUserId、mobileNumber)获取用户所在部门的所有上级父部门信息。

请求格式说明

请求方式: GET (HTTPS)

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

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

请求头部:

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

请求参数说明:

参数名 参数说明 类型 必选
userId 用户账号 string 特殊可选(userId,corpUserId和mobileNumber不能同时为空)
corpUserId 企业内唯一标识(集成用的字段) string 特殊可选(userId,corpUserId和mobileNumber不能同时为空)
mobileNumber 绑定手机号码 string 特殊可选(userId,corpUserId和mobileNumber不能同时为空)

请求示例:


curl -X GET "https://open.welink.huaweicloud.com/api/contact/v1/user/parent?userId=test123@huawei.com" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"

响应格式说明

正常返回结果

  {
    "code": 0,
    "message": "OK",
    "data": [
      {
        "deptAllCode": "1008>>2006>>3006",
        "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. ""