SuperAPI AI 工具集

zoom-oauth

安全与审计

查看项目

更新于 10-15 16:51

技能介绍

用途:为 Zoom API 提供认证与授权背景参考,覆盖凭据选择、授权流程、作用域、令牌生命周期及错误排查。建议先完成 setup-zoom-oauth 设置流程,再用本技能查看具体流程、作用域与错误细节。

主要授权流程:账户授权(Server-to-Server,grant_type 为 account_credentials)适用于无用户交互的后端自动化;用户授权(authorization_code)用于代表用户操作;设备授权(grant_type 为 urn:ietf:params:oauth:grant-type:device_code,RFC 8628)用于无浏览器设备;客户端授权(client_credentials,chatbot 作用域)仅用于聊天机器人消息操作。选择依据:后端自动化选账户授权;为其他用户构建应用且设备有浏览器选用户授权(公共客户端加 PKCE);无浏览器选设备授权;仅聊天机器人选客户端授权。

令牌获取与使用:账户授权向 POST https://zoom.us/oauth/token?grant_type=account_credentials&account_id={ACCOUNT_ID} 发送请求,Header 为 Authorization: Basic {Base64(ClientID:ClientSecret)}。用户授权先跳转 https://zoom.us/oauth/authorize,再以 authorization_code 换取令牌。访问令牌过期后一般需重新获取或使用刷新令牌;用户授权与设备授权返回 refresh_token,可调用 grant_type=refresh_token 刷新,应始终使用最新刷新令牌,刷新令牌过期后需重新授权。调用 API 时在 Header 使用 Authorization: Bearer {ACCESS_TOKEN};可将 userID 替换为 me 指向令牌关联用户,支持 /v2/users/me、/v2/users/me/meetings 等端点。撤销令牌调用 POST https://zoom.us/oauth/revoke?token={ACCESS_TOKEN}。

PKCE:适用于无法安全保存密钥的公共客户端(移动应用、SPA、桌面应用、Meeting SDK 客户端),后端服务器可选。设备流程轮询间隔约 5 秒,出现 slow_down 需增加间隔;设备码有效期约 15 分钟。

作用域:分经典作用域与细粒度作用域,细粒度格式为 <service>:<action>:<data_claim>:<access>,可标记为可选。

限制与注意事项:应用需在 Marketplace 创建并提供 Client ID/Secret,S2S 还需 Account ID;重定向 URI 必须与应用配置完全一致;公开应用才会收到取消授权 webhook,收到后需删除关联用户数据;部分账号需管理员预审批。常见错误码包括 4700、4702/4704、4705、4706、4709、4711、4717,可按资料中对应建议排查。具体收费、平台支持与完整生产示例暂未提供。