第三方应用开发 服务端API 通讯录管理 成员管理 获取部门成员
获取部门成员

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

参数说明:

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

权限说明:

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

返回结果:

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

参数说明:

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