获取成员ID列表

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

适配建议：

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

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

企业：企业自建应用可通过「读取成员」等通讯录接口获取。

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

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

企业：
企业在6月20日前创建的自建应用可通过「读取成员」等通讯录接口获取。
企业在6月20日后创建的自建应用经员工自主授权敏感信息后获取。

服务商：代开发应用经企业管理员授权且员工自主授权敏感信息后可获取。第三方应用不可获取员工的手机号和邮箱。

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

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

cursor

string

必需

用于分页查询的游标，字符串类型，由上一次调用返回，首次调用不填

limit

integer

必需

分页，预期请求的数据量，取值范围 1 ~ 10000

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

next_cursor

string

必需

分页游标，下次请求时填写以获取之后分页的记录。如果该字段返回空则表示已没有更多数据

dept_user

array [object {2}]

用户-部门关系列表

必需

userid

string

必需

用户userid，当用户在多个部门下时会有多条记录

department

integer

用户所属部门

必需

适配建议：#

请求参数

返回响应

适配建议：