苏飞论坛

标题: Asp.net【企业微信开发】成员管理(六)- 获取部门成员 [打印本页]

作者: 范范    时间: 2021-8-28 17:06
标题: 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个字节。仅第三方应用可获取







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






欢迎光临 苏飞论坛 (http://www.sufeinet.com/) Powered by Discuz! X3.4