企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
会议
Rooms会议室管理
获取控制器列表
获取控制器列表
最后更新:2023/05/30

获取企业下的控制器列表。

请求方式: 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_tokenstring调用接口凭证。获取方法查看“获取access_token
controller_namestring需要获取的控制器名称(支持模糊匹配查找)
cursorstring分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limituint32分页大小,从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"
		}
	]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
has_morebool是否还有更多Rooms会议室列表
next_cursorstring分页用,has_more为true时,下一次拉取列表将该字段填入cursor字段
controller_info_listobject[]Rooms会议室对象列表,详见ControllerInfo

ControllerInfo说明

参数说明 
rooms_idstringRooms ID
meeting_room_namestringRooms会议室名称
meeting_room_locationstringRooms会议室地址
controller_namestring控制器名称
manufacture_namestring厂商
controller_modelstring控制器型号
app_versionstring应用程序版本
statusstring设备状态:
"0":离线
"1":在线
framework_versionstring固件版本
ip_addressstringIP 地址
mac_addressstringMAC 地址
cpu_typestringCPU 类型
cpu_usagestringCPU 当前占有率
network_typestring网络类型
mem_usagestring内存使用大小
上一篇获取设备列表
下一篇获取Rooms会议室资源
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们