接口描述
描述：获取企业用户列表，目前暂不支持 OAuth2.0 鉴权访问。
调用方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/users/list?page={page}&page_size={page_size}
输入参数
以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
| 参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
| page | 是 | Integer | 当前页，大于等于1，默认为1。 |
| page_size | 是 | Integer | 分页大小，默认为20，最大为20。 |
输出参数
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| total_count | Integer | 总数。 |
| current_size | Integer | 当前页实际大小。 |
| current_page | Integer | 当前页数。 |
| page_size | Integer | 分页大小。 |
| users | Array | 数组格式，item 为用户对象。 |
用户对象
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| userid | String | 用户 userid。 |
| uuid | String | 用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。 |
| username | String | 用户 name。 |
| area | String | 手机区号。 |
| update_time | String | 更新时间。 |
| avatar_url | String | 用户图像地址。 |
| phone | String | 手机号。 |
| String | 邮箱。 | |
| status | String | 账号状态：<br>1：正常<br>2：注销<br>3：未激活<br>4：禁用 |
| staff_id | String | 员工工号。 |
| job_title | String | 员工职位。 |
| entry_time | String | 入职时间。 |
| role_name | String | 角色名称。 |
| role_code | String | 角色类型。 |
| department_list | 部门信息对象数组 | 用户部门信息。 |
部门对象
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| department_id | String | 部门 ID。 |
| department_name | String | 部门名称。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/users/list?page=1&page_size=1
输出示例
{
"total_count": 39,
"current_size": 1,
"current_page": 1,
"users": [
{
"area": "86",
"update_time": "2020-04-21 18:01:29",
"avatar_url": "",
"phone": "",
"userid": "9527",
"email": "",
"username": "testusername",
"status": "1",
"uuid": "WM4Fs4Th56ogU13JiK",
"role_name": "管理员",
"role_code": "MANAGER_ROLE",
"department_list": [{
"department_id": "674da5****************b9e938208e",
"department_name": "有用户且有子部门的部门"
}]
}
],
"page_size": 1
}
下载 腾讯会议API-用户管理-获取用户列表.pdf
文章内容是否对您有帮助？
有帮助
无帮助
能否告知我们这篇文章的问题？（选填）