获取用户列表

接口描述

描述：获取企业用户列表，目前暂不支持 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	手机号。
email	String	邮箱。
status	String	账号状态： 1：正常 2：注销 3：未激活 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
}