用途:通过 Zoom REST API(基础地址 https://api.zoom.us/v2)管理会议、网络研讨会、云录制与用户数据,适用于用户提到 Zoom、Zoom 会议、加入链接或云录制时。
认证与用法:所有调用均使用 Authorization: Bearer $ZOOM_TOKEN,该 Token 为 1 小时有效的 OAuth 访问令牌,由环境自动刷新,技能无需处理刷新令牌。当目标为已认证用户自身时,可用 me 代替用户 ID(如 /users/me/meetings)。请求失败时可运行 zero doctor check-connector --env-name ZOOM_TOKEN 或 zero doctor check-connector --url https://api.zoom.us/v2/users/me --method GET 排查。
主要能力:用户方面可获取当前用户和指定用户;会议方面可列出(type 支持 scheduled、live、upcoming、upcoming_meetings、previous_meetings)、获取、创建(type 1 即时、2 预定、3 周期性无固定时间、8 周期性固定时间)、用 PATCH 更新(成功返回 204)、删除,以及通过 PUT 状态接口将 action 设为 end 强制结束进行中的会议。历史数据可查询参会者列表与会议摘要,其中 past_meetings 端点需使用会议记录中的 uuid 字段并做 URL 编码,含 / 时需双重编码。云录制可按日期范围(必填 from 与 to,最长 30 天)列出用户录制,或按会议获取录制文件,转写文本以 file_type 为 TRANSCRIPT 出现在 recording_files 中。网络研讨会可列出与获取。
常见模式:获取最近一次云录制,或取下一场已排期会议的 join_url。
限制与注意事项:会议 ID 标识一系列会议,UUID 标识具体场次;录制与历史端点日期范围上限 30 天,需分段调用;分页通过 next_page_token 回传实现,page_size 默认 30,多数端点最大 300;时间默认 UTC,响应始终为 UTC;下载录制文件的 download_url 不使用 Bearer 认证,需追加 ?access_token=$ZOOM_TOKEN 或申请短期下载令牌,不要对其发送 Authorization: Bearer;会议创建端点属 Light 限流(≤20 请求/秒),录制列表端点属 Heavy(≤20 请求/分钟),遇 HTTP 429 应按 Retry-After 退避;所有端点使用 /v2,旧版 /v1 已废弃并返回 404。详细接口见 https://developers.zoom.us/docs/api/ 及相关子页面。