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

查询会议室（Rooms）列表

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

我的收藏

本页目录：

接口描述

描述：查询企业下的会议室列表，目前暂不支持 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
        }
    ]
}


中国站