[技术教程] 【微码开发】关于使用服务端API进行组织信息查询的问题说明
在进行微码开发的时候,有时会用到服务端API获取组织信息,通过官方文档可以很清楚的看到详细用法:
请求格式说明
请求方式: GET (HTTPS)
请求地址: https://open.welink.huaweicloud.com/api/contact/v2/departments/list
认证方式: access_token,请参考获取access_token。
属于系统层级的同步,使用type="e" 的access_token,无需使用code。
请求头部:
x-wlk-Authorization: access_token
请求参数:
参数 | 必填 | 说明 |
---|---|---|
deptCode | 是 | 部门编码,示例:0 |
recursiveflag | 是 | 0 :查询下级部门信息 1 :查询递归获取所有子部门 |
offset | 是 | 当前页,默认值是1 |
limit | 是 | 每页数量,默认值是100,最大限制每页100 |
当使用 deptCode=0&recursiveflag=0&offset=1&limit=100 来请求时,会有正确数据返回,此时获取的是0级部门的下一级部门的集合。
recursiveflag=0 表示查询下一级部门信息,不递归。
但是如果尝试使用 deptCode=0 和 recursiveflag=1 来获取数据时,就会提示 “No data found”,因为查询组织信息是不支持从0级开始递归的,文档中也有说明:
遍历说明: 1.由于初级部门编码一般为0,因此可设置deptCode=0,recursiveflag=0,获取一层组织编码(注意一级部门不支持直接遍历)。如得到一层部门编码为deptCode:1000; 2.查询1000的下一层部门,可设置deptCode=1000, recursiveflag=0; 3.如果需要查询1000下的所有部门,设置deptCode=1000, recursiveflag=1。
- 点赞
- 收藏
- 关注作者
评论(0)