获取企业成员的open_userid与对应的部门ID列表。预计于2022年8月9号发布。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/user/list_id?access_token=ACCESS_TOKEN
请求示例
{
"cursor": "xxxxxxx",
"limit": 10000
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
cursor | 否 | 用于分页查询的游标,字符串类型,由上一次调用返回,首次调用不填 |
limit | 否 | 分页,预期请求的数据量,取值范围 1 ~ 10000 |
权限说明:
必须是通讯录编辑授权才可调用。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"next_cursor": "aaaaaaaaa",
"dept_user": [
{
"open_userid": "woAAAAAAAA",
"department": 1
},
{
"open_userid": "woAAAAAAAA",
"department": 2
},
{
"open_userid": "woBBBBBBBB",
"department": 2
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
next_cursor | 分页游标,下次请求时填写以获取之后分页的记录。如果该字段返回空则表示已没有更多数据 |
dept_user | 用户-部门关系列表 |
open_userid | 用户open_userid,当用户在多个部门下时会有多条记录 |
department | 用户所属部门 |