zoom-oauth · openai — скилл для Codex: OAuth в Zoom без догадок
Скилл для Codex и ChatGPT, который разбирает потоки авторизации Zoom: выбор grant flow, области доступа, ротация refresh-токенов и разбор ошибок.
npx skills add openai/plugins --skill oauth -a codexЧто делает zoom-oauth
Скилл помогает, когда вы подключаете приложение к API Zoom и нужно понять, какой именно поток авторизации подходит. Сначала он просит определить тип приложения и действующее лицо: пользовательский OAuth, аккаунт-уровень, server-to-server, SDK JWT или учётные данные Build-платформы. Дальше уточняет целевой API или SDK, потому что области доступа и аудитория токена зависят от поверхности.
Внутри — рабочий процесс из шести шагов и набор справочников: concepts/oauth-flows.md, concepts/token-lifecycle.md, concepts/scopes-architecture.md, references/granular-scopes.md, references/oauth-errors.md и troubleshooting/redirect-uri-issues.md. Отдельный пункт про refresh-токены: их хранят как одноразовые значения, поэтому новый токен из ответа нужно сохранить до того, как старый будет использован повторно. Для локальной разработки скилл советует держать access-токены вне логов.
Автор рекомендует сначала пройти setup-zoom-oauth для первичного плана, а к этому скиллу возвращаться за точными потоками и диагностикой ошибок. Проверять запросы стоит по redirect URI, account ID, областям, статусу публикации приложения и сроку жизни токена — до правок в коде. Если в вашем сценарии используется SDK JWT, готовьтесь к тому, что логика областей будет отличаться от обычного authorization code.
Какие задачи решает
- выбрать grant flow под тип приложения Zoom
- разобраться, почему области доступа не совпадают с ожидаемыми
- настроить ротацию refresh-токенов без повторного использования старого
- диагностировать ошибку OAuth по коду ответа
- проверить redirect URI до изменения кода
Примеры запросов агенту
- Помоги настроить OAuth для приложения Zoom уровня аккаунта
- Почему при обновлении токена приходит новый refresh-токен и что с ним делать
- Разбери ошибку OAuth при подключении к Zoom API
Как установить zoom-oauth
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill oauth -a codex2Вручную: положить файлы
.agents/skills/oauth/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill oauth -a claude-code2Вручную: положить файлы
~/.claude/skills/oauth/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/oauth/
Вручную: положить файлы
.cursor/skills/oauth/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins oauth2Вручную: положить файлы
.github/skills/oauth/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/oauthВручную: положить файлы
.devin/skills/oauth/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о zoom-oauth
Как установить zoom-oauth в Claude?
Выполните npx skills add openai/plugins --skill oauth -a codex, затем файл скилла окажется по пути .agents/skills/oauth/SKILL.md.
Что делает zoom-oauth?
Разбирает реализацию авторизации Zoom: выбор потока, поведение областей доступа, обработку refresh-токенов и диагностику ошибок.
Чем zoom-oauth отличается от setup-zoom-oauth?
Первый скилл автор советует для первичного плана настройки, а zoom-oauth — для точных потоков, областей и разбора ошибок.
Исходный текст
SKILL.md · MIT
--- name: zoom-oauth description: Use when implementing OAuth. --- # Zoom OAuth Use this skill for concrete Zoom authentication implementation and troubleshooting. Prefer `setup-zoom-oauth` for the first-pass setup plan, then return here for exact flows, scope behavior, refresh handling, and error diagnosis. ## Workflow 1. Identify the app type and actor: user-level OAuth, account-level OAuth, server-to-server OAuth where officially supported, SDK JWT, or Build-platform credentials. 2. Confirm the target API, SDK, or app surface, because scopes and token audiences differ by surface. 3. Choose the grant flow: authorization code with PKCE for public clients, authorization code for confidential web apps, device authorization where appropriate, or account credentials for supported account-level automation. 4. Store refresh tokens as single-use values: persist the replacement refresh token returned by each refresh response before reusing the old one. 5. Validate requests against redirect URI, account ID, scopes, app publication state, and token expiration before changing application code. 6. For local development, keep access tokens out of logs and treat refresh tokens as single-use when rotating credentials. ## References - Full preserved guide: [references/full-guide.md](references/full-guide.md) - OAuth flows: [concepts/oauth-flows.md](concepts/oauth-flows.md) - Token lifecycle: [concepts/token-lifecycle.md](concepts/token-lifecycle.md) - Scope architecture: [concepts/scopes-architecture.md](concepts/scopes-architecture.md) - Granular scopes: [references/granular-scopes.md](references/granular-scopes.md) - OAuth errors: [references/oauth-errors.md](references/oauth-errors.md) - Redirect URI issues: [troubleshooting/redirect-uri-issues.md](troubleshooting/redirect-uri-issues.md)
© Zoom · MIT · openai/plugins
Похожие скиллы
Всё по теме «Бэкенд и API» →Сначала — zoom-oauth от других авторов.