企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端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_tokenstring调用接口凭证。获取方法查看“获取access_token
meeting_room_namestringRooms会议室名称(支持模糊匹配查找)
cursorstring分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limituint32分页大小,从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
			}
		}
	]
}

参数说明:

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

DeviceInfo说明

参数类型说明
meeting_room_idstringRooms会议室 ID
rooms_idstringRooms ID
meeting_room_namestringRooms会议室名称
meeting_room_locationstringRooms会议室地址
device_modelstring设备型号
app_versionstring激活码
meeting_room_statusuint32Rooms会议室状态:
0:未激活
1:未绑定
2:空闲
3:使用中
4:离线
device_monitor_infoobject设备健康信息,详见DeviceMonitorInfo

DeviceMonitorInfo说明

参数类型说明
camera_statusbool摄像头健康状态
microphone_statusbool麦克风健康状态
speaker_statusbool扬声器健康状态
上一篇获取Rooms会议室下的会议列表
下一篇获取控制器列表
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们