Asp.net【企业微信开发】成员管理（六）- 获取部门成员

范范

企业微信应用开发中， 重要的的地方就在于可以可以管理企业微信中的成员信息， 同步成员信息，也可以进行成员的管理。
本系列，主要说下成员管理中用到的操作，跟各操作的用法。
一、 创建成员
二、 读取成员
三、 更新成员
四、 删除成员
五、 批量删除成员
六、 获取部门成员


获取部门成员

---

   
请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD

请求参数说明：

[C#] 纯文本查看 复制代码

参数                                        必须                说明
1. access_token                是                调用接口凭证
2. department_id                是                获取的部门id
3. fetch_child                否                是否递归获取子部门下面的成员：1-递归获取，0-只获取本部门

请求返回结果：

[C#] 纯文本查看 复制代码

{
   "errcode": 0,
   "errmsg": "ok",
   "userlist": [
           {
                  "userid": "zhangsan",
                  "name": "张三",
                  "department": [1, 2],
                  "open_userid": "xxxxxx"
           }
     ]
}

返回结果参数说明：

[C#] 纯文本查看 复制代码

参数                        说明
1. errcode                返回码
2. errmsg                对返回码的文本描述内容
3. userlist                成员列表
4. userid                成员UserID。对应管理端的帐号
5. name                成员名称，代开发自建应用需要管理员授权才返回；此字段从2019年12月30日起，对新创建第三方应用不再返回真实name，使用userid代替name，2020年6月30日起，对所有历史第三方应用不再返回真实name，使用userid代替name，后续第三方仅通讯录应用可获取，未返回名称的情况需要通过通讯录展示组件来展示名字
6. department                成员所属部门列表。列表项为部门ID，32位整型
7. open_userid                全局唯一。对于同一个服务商，不同应用获取到企业内同一个成员的open_userid是相同的，最多64个字节。仅第三方应用可获取

---

权限说明：
应用须拥有指定部门的查看权限。