获取部门用户userid列表旧版SDK

更新于 2024-02-27调用本接口获取指定部门的userid列表。

说明

本接口不受通讯录权限范围限制。

重要

目前暂不支持一次性获取企业下所有员工userid值，如果开发者希望获取企业下所有员工userid值，可以通过以下方法：

企业内部应用
- 调用获取部门列表接口，通过逐级遍历，获取该企业下在授权范围内的所有部门ID。
- 调用本文档接口，分别获取每一个部门下的员工userid。
第三方企业应用
- 调用获取部门列表接口，通过逐级遍历，获取该企业下所有部门ID。
- 调用本接口，分别获取每个部门下的员工userid。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	成员信息读权限	调试
第三方企业应用	是	成员信息读权限	调试
第三方个人应用	否	—	—

基本信息

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/user/listid

Query参数

名称

类型

是否必填

示例值

描述

access_token

String

是

be3Fxxxx

调用该接口的应用凭证。

企业内部应用，通过获取企业内部应用的access_token接口获取。
第三方企业应用，通过获取第三方企业应用的access_token接口获取。

Body参数

名称

类型

是否必填

示例值

描述

dept_id

Number

是

100

部门deptId，可通过以下方式获取：

企业内部应用，可调用获取部门列表获取部门deptId。
第三方企业应用，可调用获取部门列表获取部门deptId。

说明

如果是根部门，该参数传1。

返回参数

名称	类型	示例值	描述
request_id	String	4f9kasjdhop	请求ID。
errcode	Number	0	返回码。
errmsg	String	ok	返回码描述。
result	ListUserByDeptResponse		返回结果。
userid_list	String[]	["zxxxx","lixxxi"]	指定部门的userid列表。

示例

请求示例（HTTP）

请求正文

请求示例（JAVA SDK）

返回示例

错误码

错误码（errcode）	错误码描述（errmsg）	解决方案
60003	未找到部门	请确认dept_id是否正确
400002	无效的参数	请确认参数是否合法
-1	系统繁忙	请稍后重试

这篇文档是否有帮助？

本页内容