查询指定用户部门所有父部门
根据用户信息(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 | 系统错误 |