获取账户级全量用户列表

>?账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:10次/min。

接口描述

**描述:**获取账户中的所有用户列表,目前暂不支持 OAuth2.0 鉴权访问。
**请求方法:**GET
接口请求域名:

https://api.meeting.qq.com/v1/corp/users?page={page}&page_size={page_size}

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明

参数名称 必选 参数类型 参数描述
page_size Integer 分页大小。
page Integer 当前页。
user_name String 用户名称。
userid String 用户 userid。
uuid String 用户身份 ID(腾讯会议颁发的用于开放平台的唯一用户 ID)。
status Integer 账号状态:<br>0:禁用<br>1:启用<br>2:未激活
role_code String 角色类型。

输出参数

参数名称 参数类型 参数描述
current_page Integer 当前页。
current_size Integer 当前页实际大小。
total_count Integer 数据总条数。
total_page Integer 数据总页数。
users Array 用户对象列表。

用户对象

参数名称 参数类型 参数描述
userid String 企业用户 userid。
uuid String 用户身份 ID(腾讯会议颁发的用于开放平台的唯一用户 ID)。
user_name String 企业用户 name。
area String 手机区号。
update_time String 更新时间。
avatar_url String 用户图像地址。
role_name String 角色名称。
role_code String 角色类型。
phone String 手机号。
email String 邮箱。
status Integer 账号状态。
departments department_item 部门对象列表。

部门对象

参数名称 参数类型 参数描述
id String 部门 ID。
name String 部门 name。
full_name String 部门全称(包含全部上级部门名称,不包含公司名称)。
is_main boolean 是否主部门:<br>true:是 <br>false:否

示例

输入示例

GET /v1/corp/users?page_size=20&page=1

输出示例

{
    "total_count":1,
    "total_page":1,
    "current_page":1,
    "current_size":1,
    "users":[
        {
            "userid":"testuser123",
            "uuid":"WMfgHRYj6m36mcDGtK",
            "user_name":"test123",
            "area":"86",
            "update_time":"2020-09-02 07:29:39",
            "role_name":"超级管理员",
            "role_code":"ADMIN_ROLE",
            "phone":"12365475648",
            "status":1,
            "departments":[
                {
                    "id":"123",
                    "name":"质量组",
                    "full_name":"质量部/质量组",
                    "is_main":true
                }
           ]
        }
    ]
}

下载 腾讯会议API获取账户级全量用户列表-腾讯会议.pdf
文章内容是否对您有帮助?
有帮助
无帮助