查询会议室(Rooms)列表

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

我的收藏

接口描述

描述:查询企业下的会议室列表,目前暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
接口请求域名
https://api.meeting.qq.com/v1/meeting-rooms?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
分页查询返回分页总数。
meeting_room_list
MeetingRoomList 对象数组
会议室对象列表。

MeetingRoomList 对象

参数名称
必选
参数类型
参数描述
meeting_room_id
String
会议室 ID。
meeting_room_name
String
会议室名称。
meeting_room_location
String
会议室地址。
account_new_type
Integer
账号新类型:
0:基础账号
1:专业账号
account_type
Integer
账号类型:
0:普通
1:专款
2:试用
active_code
String
激活码。
participant_number
Integer
容纳人数。
meeting_room_status
Integer
会议室状态:
0:未激活
1:未绑定
2:空闲
3:使用中
4:离线
scheduled_status
Integer
预定状态:
0:未开放预定
1:开放预定
is_allow_call
Bool
是否允许被呼叫。
true:是
false:否

错误码列表

状态码
错误码
错误描述
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
500014
账号无权限。
400
190004
参数非法,请对照接口文档检查您的参数。
500
20201
查询会议室信息失败。
500
190310
每分钟总接口调用次数超过限制。

示例

输入示例

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


输出示例

{
"total_count":200,
"total_page":100,
"current_page":1,
"current_size":2,
"meeting_room_list":[
{
"meeting_room_id":"100001",
"meeting_room_name":"会议室测试1",
"meeting_room_location":"广州-大厦-10",
"account_type":1,
"active_code":"69MS********2PKC",
"participant_number":12,
"meeting_room_status":1,
"scheduled_status":0,
"is_allow_call":true
},
{
"meeting_room_id":"100002",
"meeting_room_name":"会议室测试2",
"meeting_room_location":"西安-广场-19",
"account_type":0,
"active_code":"7G36********9Q3H",
"participant_number":13,
"meeting_room_status":0,
"scheduled_status":0,
"is_allow_call":true
}
]
}