接口描述
描述:查询指定会议室(Rooms)下的会议列表,目前暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
接口操作者权限点:需具备会议室管理的查看权限。
接口请求域名:
https://api.meeting.qq.com/v1/meeting-rooms/{operator_id}/meetings?operator_id_type={operator_id_type}&instanceid={instanceid}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id | 是 | String | 操作者 ID。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型: 1:userid |
target_rooms_id | 否 | Integer | 目标查询 roomsid。 |
target_rooms_id_type | 否 | Integer | 目标查询 roomsid 的类型: 3:rooms 设备 rooms_id 5:会议室 ID meeting_room_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 | Unix 时间戳。查询起始时间,时间区间不超过90天。 |
end_time | 否 | String | Unix 时间戳。查询结束时间,时间区间不超过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 | MeetingInfoList 会议对象数组 | 会议对象列表。 |
MeetingInfoList 会议对象
名称 | 类型 | 备注 |
meeting_id | String | 会议 ID。 |
meeting_code | String | 有效会议 Code。 |
subject | String | 会议主题。 |
status | String | 会议状态。 |
meeting_type | Integer | 会议类型: 0:一次性会议。 1:周期性会议。 2:微信专属会议。 4:rooms 投屏会议。 5:个人会议号会议。 6:网络研讨会(Webinar)。 |
start_time | Integer | 会议预订开始时间(Unix 秒)。 |
end_time | Integer | 会议预订结束时间(Unix 秒)。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 20201 | 查询会议室信息失败。 |
400 | 190301 | 请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。 |
500 | 190310 | 每分钟总接口调用次数超过限制。 |
500 | 20000 | 请检查参数类型。 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/meeting-rooms/12345/meetings?operator_id_type=5&instanceid=5
输出示例
{"current_page": 1,"current_size": 3,"total_count": 3,"total_page": 1,"meeting_info_list": [{"meeting_id": "164715334353421974423030","meeting_code": "1351434343400506","subject": "SZ43议","status": "MEETING_STATE_RECYCLED","meeting_type": 0,"start_time": 16434433491807,"end_time": 1694495407}]}