接口描述
描述:查询个人会议号(PMI)会议的会议列表(进行中、已结束),目前暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/pmi-meetings
输入参数
参数名称 | 必选 | 参数类型 | 参数说明 |
operator_id | 是 | String | 操作者 ID,即个人会议号拥有者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型: 1:企业用户 userid 3:rooms 设备 rooms_id |
instanceid | 是 | Integer | 用户的终端设备类型: 0:PSTN 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:voip、sip 设备 10:linux 20:Rooms for Touch Windows 21:Rooms for Touch MacOS 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch iOS |
start_time | 否 | String | 查询起始时间,时间区间不超过90天。 |
end_time | 否 | String | 查询结束时间,时间区间不超过90天。 |
page | 否 | Integer | 当前页,页码起始值为1,默认为1。 |
page_size | 否 | Integer | 分页大小,默认20条,最大20条。 |
输出参数
参数名称 | 参数类型 | 参数说明 |
current_page | Integer | 当前页。 |
current_size | Integer | 当前实际页大小。 |
total_count | Integer | 数据总条数。 |
total_page | Integer | 数据总页数。 |
meeting_info_list | MeetingInfo 对象数组 | 会议对象列表。 |
MeetingInfo 对象
参数名称 | 参数类型 | 参数说明 |
meeting_id | String | 会议 ID。 |
meeting_code | String | 有效会议 Code。 |
subject | String | 会议主题。 |
status | Integer | 会议状态。 |
start_time | Integer | 会议预订开始时间(UTC 秒)。 |
end_time | Integer | 会议预订结束时间(UTC 秒)。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 9002 | 非法请求。 |
500 | 190447 | 用户已禁用。 |
500 | 190446 | 用户未激活。 |
500 | 20001 | 用户不存在 |
示例
输入示例
GET https://api.meeting.qq.com/v1/pmi-meetings?operator_id_type=1&operator_id=abcd&instanceid=1&start_time=1679295600&end_time=1679637939&page=1&page_size=20
输出示例
{"current_page": 1,"current_size": 1,"total_count": 1,"total_page": 1,"meeting_info_list": [{"meeting_id": "100001","meeting_code": "12345678","subject": "tester's meeting","status": 1,"start_time": 1679295800,"end_time": 1679296800}]}