文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯会议>开放平台文档>服务端 API>REST API 参考>会议报告>用户信息查询>查询用户已结束会议列表

查询用户已结束会议列表

最近更新时间：2025-05-15 15:37:22

我的收藏

本页目录：

接口描述

描述：获取某指定用户的已结束的会议列表，可返回用户创建与参加过的已结束会议列表，支持 OAuth2.0鉴权。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/history/meetings/{userid}?page_size={page_size}&page={page}&meeting_code={meeting_code}&start_time={start_time}&end_time={end_time}


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
userid
是
String
用户的 ID（企业内部请使用企业唯一用户标识；OAuth2.0鉴权用户请使用 openId）。
page_size
是
Integer
分页大小，默认20条，最大20条。
page
是
Integer
当前页，页码起始值为1，默认为1。
meeting_code
否
String
会议号，会议号中不能包含有空格。
start_time
否
Integer
查询起始时间戳，UNIX 时间戳（单位秒）。
end_time
否
Integer
查询结束时间戳，UNIX 时间戳（单位秒）。
说明：
start_time 与 end_time 间隔时间跨度需小于等于90天。
start_time、end_time 非必填，仅输入 start_time 时，则顺延31天视为结束时间；仅输入 end_time 时，则前推31天视为起始时间。

输出参数

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

MeetingInfo 对象

参数名称
参数类型
参数描述
subject
String
会议主题。
meeting_id
String
会议的唯一标识。
meeting_code
String
会议 App 的呼入号码。
sub_meeting_id
String
周期性会议子会议号。
start_time
Integer
会议开始时间戳，UNIX 时间戳（单位秒）。
end_time
Integer
会议结束时间戳，UNIX 时间戳（单位秒）。
meeting_type
Integer
会议类型。
0：一次性会议
1：周期性会议
2：微信专属会议
4：Rooms 投屏会议
5：个人会议号会议
6：网络研讨会
说明：
如预约会议未到结束时间，或已到结束时间仍有参会成员未离会，将视为会议尚未结束，不出现在此接口返回列表中。

错误码列表

状态码
错误码
错误描述
400
500014
账号无权限。
500
190310
每分钟总接口调用次数超过限制。
400
190004
参数非法，请对照接口文档检查您的参数。
500
41
网络错误，请稍后重试。
500
960000
网络错误，请稍后重试
500
190001
存在未注册的用户。

示例一

输入示例

GET https://api.meeting.qq.com/v1/history/meetings/tester?page_size=20&page=1


输出示例

{
    "total_count": 2,
    "total_page": 1,
    "current_page": 1,
    "current_size": 2,
    "meeting_info_list": [{
        "meeting_id": "1111111111111111111",
        "meeting_code": "222222222",
        "subject": "tester预定的会议",
        "meeting_type": 0,
        "start_time": 1614308400,
        "end_time": 1614310200
    }, {
        "meeting_id": "3333333333333333333",
        "meeting_code": "444444444",
        "subject": "tester1的快速会议",
        "meeting_type": 0,
        "start_time": 1614588898,
        "end_time": 1614592498
    }]
}


示例二

输入示例

GET https://api.meeting.qq.com/v1/history/meetings/tester?page_size=20&page=1&meeting_code=222222222


输出示例

{
    "total_count": 1,
    "total_page": 1,
    "current_page": 1,
    "current_size": 1,
    "meeting_info_list": [{
        "meeting_id": "1111111111111111111",
        "meeting_code": "222222222",
        "subject": "tester预定的会议",
        "meeting_type": 0,
        "start_time": 1614308400,
        "end_time": 1614310200
    }]
}


中国站
目录