腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 会议室（Rooms）管理 > 查询设备列表

查询设备列表

最近更新时间：2023-09-15 16:09:00

我的收藏

本页目录：

接口描述

描述：查询企业下的可用设备列表，目前暂不支持 OAuth2.0 鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/devices?page={page}&page_size={page_size}&meeting_room_name={meeting_room_name}


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
page
否
Integer
页码，从1开始，默认1。
page_size
否
Integer
分页大小，从1开始，最大50，默认20。
meeting_room_name
否
String
会议室名称（支持模糊匹配查找）。

输出参数

参数名称
必选
参数类型
参数描述
total_count
是
Integer
分页查询返回数据总数。
current_size
是
Integer
分页查询返回单页数据条数。
current_page
是
Integer
分页查询返回当前页码。
total_page
是
Integer
分页查询返回分页总数。
device_info_list
否
DeviceInfoList 对象数组
设备信息对象列表。

DeviceInfoList 对象

参数名称
必选
参数类型
参数描述
meeting_room_id
是
String
会议室 ID。
rooms_id
是
String
Rooms ID。
meeting_room_name
是
String
会议室名称。
meeting_room_location
是
String
会议室地址。
device_model
否
String
设备型号。
app_version
否
String
应用程序版本。
meeting_room_status
是
Integer
会议室状态：
0：未激活
1：未绑定
2：空闲
3：使用中
4：离线
device_monitor_info
是
DeviceMonitorInfo 对象
设备健康列表。

DeviceMonitorInfo 对象

参数名称
必选
参数类型
参数描述
camera_status
是
Boolean
摄像头健康状态。
microphone_status
是
Boolean
麦克风健康状态。
speaker_status
是
Boolean
扬声器健康状态。

示例

输入示例

GET
https://api.meeting.qq.com/v1/devices?page=1&page_size=2&meeting_room_name=会议室


输出示例

{
    "total_count":200,
    "total_page":100,
    "current_page":1,
    "current_size":2,
    "device_info_list":[
        {
            "meeting_room_id":"100001",
            "rooms_id":"1445237896"
            "meeting_room_name":"会议室测试1",
            "meeting_room_location":"广州-大厦-10",
            "device_model":"TT-IP65T",
            "app_version":"999.999.999.999",
            "meeting_room_status":4,
            "device_monitor_info":{
                    "camera_status":true,
                    "microphone_status":true,
                    "speaker_status":true
                    }
        },
        {
            "meeting_room_id":"100002",
            "rooms_id":"1445336789"
            "meeting_room_name":"会议室测试2",
            "meeting_room_location":"西安-广场-19",
            "device_model":"",
            "app_version":"2.7.4.14",
            "meeting_room_status":4,
            "device_monitor_info":{
                    "camera_status":true,
                    "microphone_status":true,
                    "speaker_status":true
                    }
        }
    ]
}


中国站