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

查询会议室（Rooms）详情

最近更新时间：2024-04-23 16:12:03

我的收藏

本页目录：

接口描述

描述：根据会议室 ID 查询该会议室详细信息，目前暂不支持 OAuth2.0 鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/meeting-rooms/{meeting_room_id}

输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_room_id
是
String
会议室 ID。

输出参数

参数名称
是否必选
参数类型
参数描述
basic_info
是
BasicInfo 对象
会议室基本信息。
account_info
是
AccountInfo 对象
会议室账号信息。
hardware_info
是
HardwareInfo 对象
会议室硬件信息。
pmi_info
是
PmiInfo 对象
会议室 PMI 信息。
monitor_status
是
Integer
告警通知状态：
0：未开启
1：已开启
is_allow_call
是
Bool
是否允许被呼叫：
true：是
false：否
scheduled_status
是
Integer
预定状态：
0：未开放预定
1：开放预定

BasicInfo 对象

参数名称
必选
参数类型
参数描述
rooms_id_list
是
String 数组
Rooms ID 列表。
meeting_room_name
是
String
会议室名称。
city
是
String
城市。
building
是
String
建筑。
floor
是
String
楼层。
participant_number
是
Integer
容纳人数。
device
是
String
会议室设备。
desc
是
String
描述（base64）。
password
是
String
管理员密码（base64）。

AccountInfo 对象

参数名称
必选
参数类型
参数描述
account_new_type
是
Integer
账号新类型：
0：基础账号
1：专业账号
account_type
是
Integer
账号类型：
0：普通
1：专款
2：试用
valid_period
是
String
有效期限（普通账号有效期限即企业账号的有效期限，固定返回“-”）。

HardwareInfo 对象

参数名称
必选
参数类型
参数描述
factory
是
String
厂家。
device_model
是
String
设备型号。
sn
是
String
序列号。
ip
是
String
IP 地址。
mac
是
String
MAC 地址。
rooms_version
是
String
Rooms 版本。
firmware_version
是
String
固件版本。
health_status
是
String
健康状况。
system_type
是
String
设备系统。
meeting_room_status
是
Integer
会议室状态：
0：未激活
1：未绑定
2：空闲
3：使用中
4：离线
active_time
是
String
激活时间。
cpu_info
是
String
CPU 信息。
cpu_usage
是
String
CPU 最大占用率。
gpu_info
是
String
GPU 信息。
net_type
是
String
网络类型。
memory_info
是
String
内存信息。
monitor_frequency
是
Integer
显示器刷新率。
camera_model
是
String
摄像头型号。
enable_video_mirror
是
Boolean
是否开启视频镜像。
microphone_info
是
String
麦克风信息。
speaker_info
是
String
扬声器信息。

PmiInfo 对象

参数名称
必选
参数类型
参数描述
pmi_code
是
String
会议室专属 ID。
pmi_pwd
否
String
入会密码（base64）。

错误码列表

状态码
错误码
错误描述
400
20000
请检查参数类型。
400
190004
参数非法，请对照接口文档检查您的参数。
500
20201
查询会议室信息失败。
500
190310
每分钟总接口调用次数超过限制。

示例

输入示例

GET
https://api.meeting.qq.com/v1/meeting-rooms/100001

输出示例

{
    "basic_info":{
        "rooms_id_list":[
            "200115200039985708"
        ],
        "meeting_room_name":"会议室测试1",
        "city":"广州",
        "building":"大厦",
        "floor":"10",
        "participant_number":3,
        "device":"ROOMS",
        "desc":"aGVsbG8=",
        "password":"MzMz"
    },
    "account_info":{
        "account_type":0,
        "valid_period":"-"
    },
    "hardware_info":{
        "factory":"",
        "device_model":"",
        "sn":"",
        "ip":"10.10.10.69",
        "mac":"a1:ee:27:c1:8a:1a",
        "rooms_version":"2.7.2.420",
        "firmware_version":"",
        "health_status":"ERROR",
        "system_type":"10.13.6",
        "meeting_room_status":1,
        "active_time":"2021-03-23 15:37:34",
        "cpu_info":"Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz|Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz",
        "cpu_usage":"",
        "gpu_info":"",
        "net_type":"ethernet",
        "memory_info":"",
        "monitor_frequency":0,
        "camera_model":"FaceTime 高清摄像头（内建）",
        "enable_video_mirror":true,
        "microphone_info":"内建麦克风 ",
        "speaker_info":"内建输出"
    },
    "pmi_info":{
        "pmi_code":"12345678",
        "pmi_pwd":"XXXXXXX"
    },
    "monitor_status":0,
    "is_allow_call":true,
    "scheduled_status":1
}

中国站