获取成员ID列表

POST

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

获取企业成员的open_userid与对应的部门ID列表。预计于2022年8月9号发布。

权限说明：

必须是通讯录编辑授权才可调用。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/user/list_id' \
--header 'Content-Type: application/json' \
--data-raw '{
	"cursor": "xxxxxxx",
	"limit": 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
    }
  ]
}

请求参数

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}]

用户-部门关系列表

必需

open_userid

string

必需

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

department

integer

用户所属部门

必需

获取选人ticket对应的用户

获取单个部门详情