查询设备列表

接口描述

描述：查询企业下的可用设备列表，目前暂不支持 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	否	设备信息对象数组	设备信息对象列表。

设备信息对象

参数名称	必选	参数类型	参数描述
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	是	Object	设备健康列表。

设备健康情况

参数名称	必选	参数类型	参数描述
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",
            "meeting_room_name":"会议室测试1",
            "meeting_room_location":"广州-大厦-10",
            "device_model":"TT-IP65T",
            "app_version":"999.999.999.999",
            "meeting_room_status":4
        },
        {
            "meeting_room_id":"100002",
            "meeting_room_name":"会议室测试2",
            "meeting_room_location":"西安-广场-19",
            "device_model":"",
            "app_version":"2.7.4.14",
            "meeting_room_status":4
        }
    ]
}