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

查询用户已结束会议列表

最近更新时间：2024-04-24 17:50:11

我的收藏

本页目录：

接口描述

描述：获取某指定用户的已结束的会议列表，可返回用户创建与参加过的已结束会议列表，支持 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 组成一个时间区间，不提供则表示最近一个月；只提供 start_time 则向后推31天，只提供 end_time 则向前推31天；当提供时间跨度时，时间跨度不能大于90天。

输出参数

参数名称
参数类型
参数描述
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：微信专属会议
3：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
    }]
}


中国站