腾讯会议查询部门列表_办公协同解决方案
接口描述
描述：查询企业部门列表，仅企业下具有部门查询权限的用户可查询部门列表。不支持 OAuth2.0 鉴权访问。请求方式：GET接口请求域名：
https://api.meeting.qq.com/v1/departments?userid={userid}&department_id={department_id}&page={page}&page_size={page_size}
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| userid | 是 | String | 接口调用者 userid，必须为企业下具有部门查询权限的用户。 |
| department_id | 否 | String | 部门 ID（不传时输出全部部门列表，为0时输出全部主部门列表，其他情况返回该部门下子部门列表）。 |
| page | 否 | Integer | 分页，默认为1，最小值为1。 |
| page_size | 否 | Integer | 分页大小，默认为20，取值范围[1,20]。 |
输出参数
成功输出以下字段，失败则返回 错误码 和错误信息。
| 参数名称 | 参数类型 | 参数描述 |
| total_page | Integer | 数据总页数。 |
| total_count | Integer | 数据总条数。 |
| department_list | DepartmentList 对象数组 | 部门对象列表。 |
| current_size | Integer | 当前页实际大小。 |
| current_page | Integer | 当前页。 |
DepartmentList 对象
| 参数名称 | 参数类型 | 参数描述 |
| department_id | String | 部门 ID。 |
| department_name | String | 部门名称。 |
| department_full_name | String | 部门全称。 |
| is_main_department | Boolean | 是否是主部门。 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/departments?userid=meeting4548079&page=1&page_size=20
输出示例
{ "total_count": 4, "total_page": 1, "current_page": 1, "current_size": 4, "department_list": [{ "department_id": "e99f0********65361e1c78c7e08465b", "department_name": "test-子部门-02", "department_full_name": "test-主部门-01/test-子部门-02", "is_main_department": false }, { "department_id": "b3295fd11********843532c689536", "department_name": "test-子部门-01", "department_full_name": "test-主部门-01/test-子部门-01", "is_main_department": false }, { "department_id": "07f4c15b6616**********966815d251", "department_name": "test-主部门-02", "department_full_name": "test-主部门-02", "is_main_department": true }, { "department_id": "1519a9a1a985e**********a464bf856", "department_name": "test-主部门-01", "department_full_name": "test-主部门-01", "is_main_department": true }]}
对腾讯办公协同的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
