查询部门用户列表
接口描述
描述：查询企业部门用户列表，仅企业下具有部门查询权限和查询用户列表权限的用户可查询部门用户列表。不支持 OAuth2.0 鉴权访问。
调用方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/departments/{departmentId}/users?userid={userid}&page={page}&page_size={page_size}
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
| 参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
| userid | 是 | String | 接口调用者 serid，必须为企业下具有部门查询权限的用户。 |
| page | 否 | Integer | 分页，默认为1，最小值为1。 |
| page_size | 否 | Integer | 分页大小，默认为20，取值范围[1,20]。 |
输出参数
成功输出以下字段，失败则返回 错误码 和错误信息。
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| total_page | Integer | 数据总页数。 |
| total_count | Integer | 数据总条数。 |
| current_size | Integer | 当前页实际大小。 |
| current_page | Integer | 当前页。 |
| users | 用户对象数组 | 用户对象列表。 |
**用户
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| userid | String | 企业用户 userid。 |
| uuid | String | 用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。 |
| user_name | String | 企业用户 name。 |
| role_name | String | 角色名称。 |
| role_code | String | 角色类型。 |
| area | String | 手机区号。 |
| phone | String | 手机号。 |
| String | 邮箱。 | |
| status | Integer | 账号状态：<br>1：正常<br>2：删除<br>3：未激活<br>4：禁用 |
| staff_id | String | 工号。 |
| job_title | String | 职位。 |
| entry_time | String | 入职时间。 |
| department_id | String | 部门 ID。 |
| department_name | String | 部门名称。 |
示例
输入示例
GET
https://api.meeting.qq.com/v1/departments/b3295f********f3f58843532c689536/users?userid=meeting4548079
输出示例
{
"total_count": 1,
"total_page": 1,
"current_page": 1,
"current_size": 1,
"users": [{
"userid": "department-test",
"uuid": "WMYP3NjSg7npGMnGQt",
"user_name": "department-tester",
"role_name": "普通成员",
"role_code": "NORMAL_ROLE",
"area": "86",
"phone": "18482268545",
"email": "1194128594@qq.com",
"status": 1,
"staff_id": "9999",
"job_title": "departmnt-test",
"entry_time": "2021-08-09T00:00:00+08:00",
"department_id": "b3295fd1********f58843532c689536",
"department_name": "haynes-子部门-01"
}]
}
下载 查询部门用户列表.pdf
文章内容是否对您有帮助？
有帮助
无帮助
能否告知我们这篇文章的问题？（选填）