用途:作为 Zoom API 认证与令牌生命周期的参考技能,在完成 setup-zoom-oauth 后用于查询具体授权流程、scope 和错误细节。
主要能力:介绍四类授权场景——账号授权(Server-to-Server,grant_type=account_credentials)、用户授权(授权码,authorization_code)、设备授权(urn:ietf:params:oauth:grant-type:device_code,RFC 8628)、客户端授权(client_credentials,仅聊天机器人 IM 消息操作)。说明访问令牌使用(Authorization: Bearer {ACCESS_TOKEN})、/v2/users/me 等 me 上下文端点、令牌撤销接口、PKCE(RFC 7636)适用场景与 Node.js 实现、取消授权 webhook(app_deauthorized)、预审批流程、Active Apps Notifier,以及 classic 与 granular 两类 scope。
必要用法:应用需在 Marketplace 创建,准备 Client ID、Client Secret,S2S 还需 Account ID。换令牌端点多为 POST https://zoom.us/oauth/token,Basic 头为 Base64(ClientID:ClientSecret);S2S 与客户端授权令牌 1 小时过期且无刷新流程;用户与设备授权提供 refresh_token,刷新须使用最新 refresh token。设备码轮询按 interval(约 5 秒),遇 slow_down 增加 5 秒,authorization_pending 继续轮询,expired_token(15 分钟)与 access_denied 终止。
适用场景:后端自动化、代表用户的应用、无浏览器设备(如 Meeting SDK)、聊天机器人消息操作,以及移动端、SPA、桌面端等无法安全保存密钥的公开客户端。
限制:refresh token 有效期可能变动(用户类流程常见约 90 天),应以运行时错误和重新授权兜底;redirect_uri 须与应用配置完全一致;设备流程需在 Features > Embed > Enable Meeting SDK 中启用 Use App on Device;deauthorization webhook 仅公开应用可接收,且收到后须删除关联用户数据。文档列出的错误码 4700-4741 等可对照排查。具体收费、价格与平台支持暂未提供。