接口描述
描述：查询企业下的控制器列表，目前暂不支持 OAuth2.0 鉴权访问。
请求方式： GET
接口操作者权限点：需具备会议室管理的查看权限。
接口请求域名：
https://api.meeting.qq.com/v1/meeting-rooms-monitor/device-controller-info&operator_id={operator_id}&operator_id_type={operator_id_type}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id | 是 | String | 操作者 ID。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型： 1：userid |
controller_name | 否 | String | 需要查询的设备名称（支持模糊匹配查找），如需获取全量列表，则不需要传入。 |
page | 否 | Integer | 页码，从1开始。 |
page_size | 否 | Integer | 分页大小，从1开始，最大50。 |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
total_count | 是 | Number | 分页查询返回数据总数。 |
current_page | 是 | Number | 分页查询返回当前页码。 |
current_size | 是 | Number | 分页查询返回单页数据条数。 |
total_page | 是 | Number | 分页查询返回分页总数。 |
controller_info_list | 是 | ControllerInfoList 对象列表 | 控制器信息对象。 |
ControllerInfoList 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
rooms_id | 是 | String | Rooms ID。 |
meeting_room_name | 是 | String | 会议室名称。 |
meeting_room_location | 是 | String | 会议室地址。 |
controller_name | 是 | String | 控制器名称。 |
manufacture_name | 是 | String | 厂商。 |
controller_model | 是 | String | 控制器型号。 |
app_version | 是 | String | 应用程序版本。 |
status | 是 | String | 设备状态： 0：离线 1：在线 |
framework_version | 是 | String | 固件版本。 |
ip_address | 是 | String | IP 地址。 |
mac_address | 是 | String | MAC 地址。 |
cpu_type | 是 | String | CPU 类型。 |
cpu_usage | 是 | String | CPU 当前占有率。 |
network_type | 是 | String | 网络类型。 |
mem_usage | 是 | String | 内存使用大小。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法，请对照接口文档检查您的参数。 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/meeting-rooms-monitor/device-controller-info?controller_name=igelschen&operator_id=14411xxxxxxxxxx002&operator_id_type=1
输出示例
{"total_count": 6,"current_page": 1,"current_size": 6,"total_page": 1,"controller_info_list": [{"meeting_room_name": "nigxxxxxeng-test123","meeting_room_location": "西安-新长安广场-19","controller_name": "nxxxxxxeng-test123","manufacture_name": "Apple","controller_model": "Apple","app_version": "x.x.x.x","status": "0","framework_version": "iOS 15.2.1","ip_address": "x.x.x.x","mac_address": "x:x:x:x:x:x","cpu_type": "ARM64","cpu_usage": "1.7","network_type": "wifi","mem_usage": "3.6GB","rooms_id": "14411xxxxxxxx59565"},{"meeting_room_name": "nigxxxxxeng-test123","meeting_room_location": "西安-新长安广场-19","controller_name": "nigxxxxxeng-test123","manufacture_name": "Apple","controller_model": "Apple","app_version": "x.x.x.x","status": "0","framework_version": "iOS 14.0.1","ip_address": "x.x.x.x","mac_address": "x:x:x:x:x:x","cpu_type": "ARM64","cpu_usage": "2.3","network_type": "wifi","mem_usage": "2.9GB","rooms_id": "14411xxxxxxxx59565"},{"meeting_room_name": "nigxxxxxeng-test123","meeting_room_location": "西安-新长安广场-19","controller_name": "nigxxxxxeng-test123","manufacture_name": "LENOVO","controller_model": "LENOVO","app_version": "x.x.x.x","status": "0","framework_version": "Windows Windows_10_Desktop","ip_address": "x.x.x.x","mac_address": "40-xx-xx-xx-xx-ef","cpu_type": "","cpu_usage": "0","network_type": "wifi","mem_usage": "8022GB","rooms_id": "14411xxxxxxxx59565"},{"meeting_room_name": "nigxxxxxeng-test123","meeting_room_location": "西安-新长安广场-19","controller_name": "nigxxxxxeng-test123","manufacture_name": "LENOVO","controller_model": "LENOVO","app_version": "x.x.x.x","status": "0","framework_version": "Windows Windows_10_Desktop","ip_address": "x.x.x.x","mac_address": "40-xx-xx-xx-xx-ef","cpu_type": "","cpu_usage": "0","network_type": "wifi","mem_usage": "8022GB","rooms_id": "14411xxxxxxxx59565"},{"meeting_room_name": "nigxxxxxeng-test123","meeting_room_location": "西安-新长安广场-19","controller_name": "nigxxxxxeng-test123","manufacture_name": "LENOVO","controller_model": "LENOVO","app_version": "x.x.x.x","status": "0","framework_version": "Windows Windows_10_Desktop","ip_address": "x.x.x.x","mac_address": "40-xx-xx-xx-xx-ef","cpu_type": "","cpu_usage": "0","network_type": "wifi","mem_usage": "8022GB","rooms_id": "144115264330461224"},{"meeting_room_name": "nigxxxxxeng-test123","meeting_room_location": "西安-新长安广场-19","controller_name": "nigxxxxxeng-test123","manufacture_name": "Apple","controller_model": "Apple","app_version": "x.x.x.x","status": "0","framework_version": "iOS 15.2.1","ip_address": "x.x.x.x","mac_address": "40-xx-xx-xx-xx-ef","cpu_type": "ARM64","cpu_usage": "24.9","network_type": "wifi","mem_usage": "3.6GB","rooms_id": "14411xxxxxxxx59565"}]}
