说明:
账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:100次/min。
接口描述
描述:获取账户中在指定时间段内已经结束的会议列表,目前暂不支持 OAuth2.0 鉴权访问。单次最多支持查询10万条数据。
请求方式:GET
自建应用权限点:查看企业会议基本信息,管理企业会议基本信息。
接口请求域名:
https://api.meeting.qq.com/v1/corp/meetings?page={page}&page_size={page_size}&meeting_state={meeting_state}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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 | 会议结束时间,媒体房间维度,单位毫秒。 |
participants_num | Integer | 参会人数。 |
meeting_duration | String | 会议持续时长,单位毫秒。 |
user_meeting_duration | String | 用户会议时长,单位毫秒。 |
示例
输入示例
GET /v1/corp/meetings?meeting_state=1&page_size=20&page=1
输出示例
{"total_count":2,"total_page":1,"current_page":1,"current_size":2,"meeting_info_list":[{"subject":"test1","meeting_id":"123456987","meeting_code":"13546812","userid":"testuser1","nick_name":"testuesr","start_time":12346554123,"end_time":3154842123,"participants_num":1,"meeting_duration":30057,"user_meeting_duration":26728},{"subject":"xianminxiao预定的网络研讨会","meeting_id":"2882809173109452722","meeting_code":"594530158","userid":"xianminxiao","userid_type":1,"nick_name":"xianminxiao","start_time":1611143122615,"end_time":1611143209838,"participants_num":1,"meeting_duration":87223,"user_meeting_duration":83701}]}