获取设备列表 - 接口文档 - 企业微信开发者中心

企业内部开发服务端API 会议 Rooms会议室管理获取设备列表

获取设备列表

最后更新：2023/05/30

获取企业下的可用设备列表。

请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/meeting/rooms/list_devices?access_token=ACCESS_TOKEN

请求包体：

{
	"meeting_room_name": "ROOMNAME",
	"cursor": "CURSOR",
	"limit": 50
}

参数说明：

参数	必须	类型	说明
access_token	是	string	调用接口凭证。获取方法查看“获取access_token”
meeting_room_name	否	string	Rooms会议室名称（支持模糊匹配查找）
cursor	否	string	分页查询用，将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limit	否	uint32	分页大小，从1开始，最大50，默认20

注意：
limit参数必须与首次调用获得cursor时传入的limit一致。

权限说明

仅配置在“可调用接口的应用”列表中的自建应用可调用

返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
	"has_more": true,
	"next_cursor": "CURSOR",
	"device_info_list":[
		{
			"meeting_room_id":"100001",
			"rooms_id": "45613",
			"meeting_room_name":"会议室测试1",
			"meeting_room_location":"广州-大厦-10",
			"device_model": "TT-IP65T",
			"app_version":"4.1.6.0",
			"meeting_room_status":1,
			"device_monitor_info": {
				"camera_status": true,
				"microphone_status": true,
				"speaker_status": true
			}
		}
	]
}

参数说明：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
has_more	bool	是否还有更多Rooms会议室列表
next_cursor	string	分页用，has_more为true时，下一次拉取列表将该字段填入cursor字段
device_info_list	object[]	设备信息对象列表，详见DeviceInfo

DeviceInfo说明

参数	类型	说明
meeting_room_id	string	Rooms会议室 ID
rooms_id	string	Rooms ID
meeting_room_name	string	Rooms会议室名称
meeting_room_location	string	Rooms会议室地址
device_model	string	设备型号
app_version	string	激活码
meeting_room_status	uint32	Rooms会议室状态： 0：未激活 1：未绑定 2：空闲 3：使用中 4：离线
device_monitor_info	object	设备健康信息，详见DeviceMonitorInfo

DeviceMonitorInfo说明

参数	类型	说明
camera_status	bool	摄像头健康状态
microphone_status	bool	麦克风健康状态
speaker_status	bool	扬声器健康状态

获取Rooms会议室下的会议列表

获取控制器列表

本节内容

获取设备列表