查询会议室(Rooms)详情

最近更新时间:2024-07-08 11:48:53

我的收藏

接口描述

描述:根据会议室 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
}