获取部门成员

GET

https://qyapi.weixin.qq.com/cgi-bin/user/simplelist

服务端API企业内部开发第三方应用开发智慧硬件开发

企业通讯录安全特别重要，企业微信将持续升级加固通讯录接口的安全机制，以下是关键的变更点：

**【重要】**从2022年8月15日10点开始，“企业管理后台 - 管理工具 - 通讯录同步”的新增IP将不能再调用此接口，企业可通过「获取成员ID列表」和「获取部门ID列表」接口获取userid和部门ID列表。查看调整详情。

参数说明：

如需获取该部门及其子部门的所有成员，需先获取该部门下的子部门，然后再获取子部门下的部门成员，逐层递归获取。

权限说明：

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

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=&department_id'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

department_id

获取的部门id

必需

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

userlist

array [object {4}]

成员列表

必需

userid

string

可选

成员UserID。对应管理端的帐号

name

string

可选

成员名称，代开发自建应用需要管理员授权才返回；此字段从2019年12月30日起，对新创建第三方应用不再返回真实name，使用userid代替name，2020年6月30日起，对所有历史第三方应用不再返回真实name，使用userid代替name，后续第三方仅通讯录应用可获取，未返回名称的情况需要通过通讯录展示组件来展示名字

department

array[integer]

可选

成员所属部门列表。列表项为部门ID，32位整型

open_userid

string

可选

全局唯一。对于同一个服务商，不同应用获取到企业内同一个成员的open_userid是相同的，最多64个字节。仅第三方应用可获取

修改于 2022-11-30 08:39:31

批量删除成员

获取部门成员详情