开放查询子部门信息
【摘要】 查询子部门信息根据部门编码查询子部门信息。请求格式说明请求方式： GET (HTTPS)请求地址： https://open.welink.huaweicloud.com/api/contact/v2/departments/list认证方式： access_token，请参考获取access_token请求头部：x-wlk-Authorization: access_token请求参数： ...
查询子部门信息
根据部门编码查询子部门信息。
请求格式说明
请求方式： GET (HTTPS)
请求地址： https://open.welink.huaweicloud.com/api/contact/v2/departments/list
认证方式： access_token，请参考获取access_token
请求头部：
x-wlk-Authorization: access_token
请求参数：
| 参数 | 必填 | 说明 |
|---|---|---|
| deptCode | 是 | 部门编码，示例：0 |
| recursiveflag | 是 | 0 ：查询下级部门信息 1 ：查询递归获取所有子部门 |
| offset | 是 | 当前页，默认值是1 |
| limit | 是 | 每页数量，默认值是100，最大限制每页100 |
遍历说明：1.由于初级部门编码一般为0，因此可设置deptCode=0，recursiveflag=0，获取一层组织编码（注意一级部门不支持直接遍历）。如得到一层部门编码为deptCode：1000； 2.查询1000的下一层部门，可设置deptCode=1000， recursiveflag=0； 3.如果需要查询1000下的所有部门，设置deptCode=1000， recursiveflag=1。
请求示例：
curl -H 'x-wlk-Authorization: access_token' https://open.welink.huaweicloud.com/api/contact/v2/departments/list?deptCode=0&recursiveflag=0&offset=1&limit=100
响应格式说明
返回结果：
{ "code": "0", "message": "OK", "offset": 100, "limit": 25, "totalCount": 327, "departmentInfo": [
{ "deptCode": "1", "deptNameCn": "产品销售部", "deptNameEn": "Sales Dept", "fatherCode": "0", "deptLevel": "2", "orderNo": 1
},
{ "deptCode": "2", "deptNameCn": "产品研发部", "deptNameEn": "Products Dept", "fatherCode": "0", "deptLevel": "2", "orderNo": 2
},
{ // 更多部门
}
]
}返回参数说明：
| 参数 | 说明 |
|---|---|
| code | 数据正常返回“0”，如果发生错误，会返回对应的错误码。 |
| message | 返回信息，包括接口请求发生错误时的详细信息。 |
| totalCount | 当前部门下所有部门数，如果当前部门为0级，仅能获取下一级的所有部门。 |
| deptCode | 部门编码，如1。 |
| deptNameCn | 部门名称中文。 |
| deptNameEn | 部门名称英文。 |
| fatherCode | 上一个层级部门编码。 |
| deptLevel | 组织层级编码，如XX公司是组织层级是0，XX公司->研发部 则研发部层级是1。 |
| orderNo | 部门排序，该字段在部门维护时设定的，如果不维护则默认为1000。 |
错误码说明：
| 参数名 | 参数类型 | 是否必填 | 参数含义 |
|---|---|---|---|
| code | int | 是 | 错误码： >> 0 : OK >> 47000 : 无权限 >> 47001 : 当前登陆用户信息获取失败 >> 47002 : 部门编码为空 >> 47003 : 参数为空 >> 47004 : 参数不对 >> 47007 : 当前登陆者是非法用户或个人详情已失效 >> 47008 : 参数校验不通过 >> 47009 : 提交失败 >> 47012 : 无数据 >> 47013 : 查询数量限制 >> 47100 : 待处理 >> 47101 : Token格式错误 >> 47102 : 无权限 >> 47103 : Token过期 >> 47104 : 处理中 >> 47105 : 秘书账号未创建 >> 47106 : 上级部门未创建 >> 500 : 系统错误 |
| message | string | 是 | 错误信息 |
【版权声明】本文为华为云社区用户原创内容，未经允许不得转载，如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱：
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论（0）