接口描述
描述:根据会议室 ID 查询该会议室详细信息,目前暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/meeting-rooms/{meeting_room_id}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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 | 每分钟总接口调用次数超过限制。 |
示例
输入示例
GEThttps://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}