腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 账户级接口 > 获取账户级即将召开的会议列表

获取账户级即将召开的会议列表

最近更新时间：2024-03-05 11:07:32

我的收藏

本页目录：

说明：
账户级接口属于仅账户管理员可以使用的接口，是重量级接口，查询的信息量比较大，访问限制：100次/min。

接口描述

描述：获取账户中在指定时间段内即将召开的会议列表（最新预定的会议将有30秒延时展示），目前暂不支持 OAuth2.0 鉴权访问。单次最多支持查询10万条数据。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/corp/meetings?page={page}&page_size={page_size}&meeting_state={meeting_state}

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明。
参数名称
必选
参数类型
参数描述
page_size
是
Integer
分页大小。
page
是
Integer
当前页。
meeting_code
否
String
会议号。
meeting_state
是
Integer
会议状态：
1：结束会议
2：实时会议
3：即将开始的会议
start_time
否
Integer
搜索的开始时间（预定会议的开始时间），单位秒。
end_time
否
Integer
搜索的结束时间（预定会议的开始时间），单位秒。

输出参数

参数名称
参数类型
参数描述
current_page
Integer
当前页。
current_size
Integer
当前页实际大小。
total_count
Integer
数据总条数。
total_page
Integer
数据总页数。
meeting_info_list
MeetingInfoList 对象数组
会议对象。

MeetingInfoList 对象

参数名称
参数类型
参数描述
meeting_id
String
会议 ID。
meeting_code
String
会议 Code。
subject
String
会议主题。
userid
String
创建者 userid。
userid_type
Integer
创建者 ID 类型。
1：userid
3：rooms_id
nick_name
String
创建者昵称。
start_time
Integer
会议开始时间，单位秒。
end_time
Integer
会议结束时间，单位秒。
online_member_num
Integer
在线人数。
meeting_state
Integer
会议状态：
1：结束会议
2：实时会议
3：即将开始的会议
meeting_type
Integer
会议类型。
0：一次性会议
1：周期性会议
6：网络研讨会

示例

输入示例

GET /v1/corp/meetings?meeting_state=3&page_size=20&page=1

输出示例

{
"total_count":2,
"total_page":1,
"current_page":1,
"current_size":2,
"meeting_info_list":[
    {
        "subject":"test123",
        "meeting_id":"12333212312123",
        "meeting_code":"95943474",
        "userid":"testuserid",
        "nick_name":"",
        "start_time":1595409764,
        "end_time":1626945764,
        "online_member_num":0,
        "meeting_state":3,
        "meeting_type":0
    },
    {
        "subject":"test1233",
        "meeting_id":"1339444",
        "meeting_code":"2312312",
        "userid":"testuserid1",
        "userid_type":1,
        "nick_name":"fasdf",
        "start_time":1594002163,
        "end_time":1625538163,
        "online_member_num":0,
        "meeting_state":3,
        "meeting_type":0
     }
  ]
}

中国站