腾讯会议查询部门用户列表_办公协同解决方案
接口描述
描述:查询企业部门用户列表,仅企业下具有部门查询权限和查询用户列表权限的用户可查询部门用户列表。不支持 OAuth 2.0鉴权访问。请求方式:GET接口请求域名:
https://api.meeting.qq.com/v1/departments/{departmentId}/users?userid={userid}&page={page}&page_size={page_size}
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称 | 必选 | 参数类型 | 参数描述 |
userid | 是 | String | 接口调用者 userid,必须为企业下具有部门查询权限的用户。 |
page | 否 | Integer | 分页,默认为1,最小值为1。 |
page_size | 否 | Integer | 分页大小,默认为20,取值范围[1,20]。 |
输出参数
成功输出以下字段,失败则返回 错误码 和错误信息。
参数名称 | 参数类型 | 参数描述 |
total_page | Integer | 数据总页数。 |
total_count | Integer | 数据总条数。 |
current_size | Integer | 当前页实际大小。 |
current_page | Integer | 当前页。 |
users | Users 对象数组 | 用户对象列表。 |
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 | 账号状态:1:正常2:删除3:未激活4:禁用 |
staff_id | String | 工号。 |
job_title | String | 职位。 |
entry_time | String | 入职时间。 |
department_id | String | 部门 ID。 |
department_name | String | 部门名称。 |
示例
输入示例
GEThttps://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": "WMYP3********MnGQt", "user_name": "department-tester", "role_name": "普通成员", "role_code": "NORMAL_ROLE", "area": "86", "phone": "184****8545", "email": "119****594@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": "hay***-子部门-01" }]}
对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案