获取账户级全量用户列表
>?账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制: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 | 手机号。 |
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
文章内容是否对您有帮助?
有帮助
无帮助
能否告知我们这篇文章的问题?(选填)