获取用户部门详情
通过部门Id获取部门详细信息,如部门名称、上级部门、部门的主管。
请求格式说明
请求方式: GET (HTTPS)
请求地址: https://open.welink.huaweicloud.com/api/contact/v1/departments/{deptcode}
认证方式: access_token,请参考获取access_token。
请求头部:
x-wlk-Authorization: access_token
请求参数:
参数 | 说明 |
---|---|
deptCode | 部门编码,从用户详细信息中获取部门编码 |
请求示例:
curl -H "x-wlk-Authorization: access_token" https://open.welink.huaweicloud.com/api/contact/v1/departments/{deptcode}
响应格式说明
返回结果:
{
"code": "0",
"message": "ok",
"deptCode": "10001", //部门Id, Key值
"deptNameCn": "开发部", //部门中文名称
"deptNameEn": "Development Dept", //部门英文名称
"parentCode": 10000, //上级部门ID
"managerId": "zhangshan@welink" //部门主管(员工帐号)
}
返回参数说明:
参数 | 说明 |
---|---|
code | 数据正常返回“0”,如果发生错误,会返回对应的错误码。 |
message | 返回信息,包括接口请求发生错误时的详细信息。 |
deptCode | 部门Id, Key值 |
deptNameCn | 部门中文名称 |
deptNameEn | 部门英文名称 |
parentCode | 上级部门ID |
managerId | 部门主管(员工帐号) |
错误码说明:
错误码 | 说明 |
---|---|
47001 | 当前登录用户信息获取失败 |
47009 | 无数据 |
500 | 系统错误 |