获取企业下的控制器列表。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/meeting/rooms/list_controllers?access_token=ACCESS_TOKEN
请求包体:
{
"controller_name": "NAME",
"cursor": "CURSOR",
"limit": 20
}
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | 调用接口凭证。获取方法查看“获取access_token” |
controller_name | 否 | string | 需要获取的控制器名称(支持模糊匹配查找) |
cursor | 否 | string | 分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值 |
limit | 否 | uint32 | 分页大小,从1开始,最大50,默认20 |
注意:
limit参数必须与首次调用获得cursor时传入的limit一致。
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"has_more": true,
"next_cursor": "CURSOR",
"controller_info_list":[
{
"rooms_id":"12356",
"meeting_room_name":"会议室测试1",
"meeting_room_location":"广州-大厦-10",
"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"
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
has_more | bool | 是否还有更多Rooms会议室列表 |
next_cursor | string | 分页用,has_more为true时,下一次拉取列表将该字段填入cursor字段 |
controller_info_list | object[] | Rooms会议室对象列表,详见ControllerInfo |
ControllerInfo说明
参数 | 说明 | |
---|---|---|
rooms_id | string | Rooms ID |
meeting_room_name | string | Rooms会议室名称 |
meeting_room_location | string | Rooms会议室地址 |
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 | 内存使用大小 |