集成 Zoom OAuth 认证时正确选择应用类型、授权流…

在设置 Zoom 应用凭据、选择 OAuth 授权流、申请 scope、处理 token 刷新或调试认证失败时使用。

适用场景

解决思路

1. 先确定应用模型和应用类型：明确谁授权谁，以及相关的用户、账号/租户和应用类型。
2. 根据授权主体和租户模型选择正确的 OAuth grant flow。
3. 确认精确的用户流程后，识别该流程所需的最小 scopes。
4. 定义 token 的存储方式与刷新行为，并处理 token 生命周期。
5. 执行 token exchange 和 refresh；刷新成功后存储新返回的 refresh token，不要继续使用旧 refresh token。
6. 调试认证失败时，先检查应用配置和环境假设，而不是直接当作 API 失败。
7. 只有在应用模型、授权流、scopes、token 存储与刷新都清楚后，再进入最相关的深层参考文档：oauth、general、rest-api。

适用边界 · 注意事项

• 未先澄清授权主体和租户模型时，不要选择 OAuth grant；未确认精确工作流前，不要申请宽泛 scopes。
• 不要忽略 refresh-token 行为和 token 生命周期，也不要在刷新成功后复用旧 refresh token。
• 不要把认证失败当作 API 失败，必须先检查应用配置和环境假设。