腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 账户级接口 > 获取账户级角色用户列表

获取账户级角色用户列表

最近更新时间：2024-04-24 17:50:13

我的收藏

本页目录：

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

接口描述

描述：获取账户中的被分配给某一个角色的所有用户列表，目前暂不支持 OAuth2.0 鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/corp/users?page={page}&page_size={page_size}&role_code={role_code}

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明。
参数名称
必选
参数类型
参数描述
page_size
是
Integer
分页大小。
page
是
Integer
当前页。
user_name
否
String
用户名称。
userid
否
String
用户 userid。
uuid
否
String
用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。
status
否
Integer
账号状态：
0：禁用
1：启用
2：未激活
role_code
否
String
角色类型。

输出参数

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

Users 对象

参数名称
参数类型
参数描述
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
Departments 对象数组
部门对象列表。

Departments 对象

参数名称
参数类型
参数描述
id
String
部门 ID。
name
String
部门 name。
full_name
String
部门全称（包含全部上级部门名称，不包含公司名称）。
is_main
boolean
是否主部门：
true：是
false：否

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
400
500014
账号无权限。

示例

输入示例

GET https://api.meeting.qq.com/v1/corp/users?page_size=20&page=1&role_code=NORMAL_ROLE

输出示例

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

中国站