获取企业成员的userid与对应的部门ID列表，预计于2022年8月8号发布。若需要获取其他字段，参见「适配建议」。

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/user/list_id?access_token=ACCESS_TOKEN

请求示例

{
	"cursor": "xxxxxxx",
	"limit": 10000
}

参数说明：

权限说明：

仅支持通过“通讯录同步secret”调用。

返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
	"next_cursor": "aaaaaaaaa",
	"dept_user": [
		{
			"userid": "zhangsan",
			"department": 1
		},
		{
			"userid": "zhangsan",
			"department": 2
		},
		{
			"userid": "lisi",
			"department": 2
		}
	]
}

参数说明：

适配建议：

为保障企业数据安全，应用应当尽量减少通过服务端接口获取通讯录信息，尤其是成员的敏感字段。

若需要获取员工基本信息（姓名、部门名）

• 企业：企业自建应用可通过「读取成员」等通讯录接口获取。
• 服务商：代开发应用经企业管理员授权后可通过「读取成员」等通讯录接口获取。第三方应用不可直接获取姓名和部门名，可以通过“通讯录展示组件”在页面内展示姓名和部门名，完成应用功能。
  
  

若需要获取员工敏感信息（手机号、邮箱）

• 企业：
  企业在6月20日前创建的自建应用可通过「读取成员」等通讯录接口获取。
  企业在6月20日后创建的自建应用经员工自主授权敏感信息后获取。
  
  
• 服务商：代开发应用经企业管理员授权且员工自主授权敏感信息后可获取。第三方应用不可获取员工的手机号和邮箱。