获取控制器列表 - 接口文档 - 企业微信开发者中心

企业内部开发服务端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_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	内存使用大小

获取设备列表

获取Rooms会议室资源

本节内容

获取控制器列表