build-zoom-rest-api-app · openai — скилл для Codex: что делает и как установить
Скилл настраивает работу с REST API сервиса Zoom из кода приложения. Он помогает выстроить авторизацию, работу с вебхуками и обработку лимитов запросов.
npx skills add openai/plugins --skill rest-api -a codexЧто делает build-zoom-rest-api-app
Скилл задаёт строгий процесс вызова REST API Zoom для управления встречами, записями, вебинарами, чатами, телефонными линиями и пользователями. Перед написанием кода агент определяет нужного субъекта и подбирает необходимые права доступа (scopes) по справочникам.
Внутри заложены правила генерации обёрток: обязательный учёт пагинации, повторных попыток при сбоях, идемпотентности и заголовков с рейлимитами. Обработка вебхуков выносится в отдельный поток с проверкой цифровой подписи и защитой от повторных событий.
Авторизация строго разграничена: user-level OAuth берётся для личных данных, account-level — для действий администратора, а server-to-server OAuth разрешён только для эндпоинтов с прямой поддержкой в документации. Это исключает отказ в доступе из-за неверной аудитории токена.
Какие задачи решает
- настроить клиент для работы с API встреч и вебинаров Zoom
- разграничить права доступа и авторизацию между User OAuth и Server-to-Server OAuth
- реализовать валидацию подписи и защиту от повторов для входящих вебхуков
- встроить обработку пагинации, повторных запросов и заголовков рейтлимитов
Примеры запросов агенту
- Напиши обёртку для создания встречи через Zoom REST API с поддержкой рейтлимитов
- Настрой обработчик входящих вебхуков Zoom с проверкой сигнатуры и защитой от дублей
- Помоги подобрать scopes и авторизацию для получения записей пользователей в Zoom
Как установить build-zoom-rest-api-app
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill rest-api -a codex2Вручную: положить файлы
.agents/skills/rest-api/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill rest-api -a claude-code2Вручную: положить файлы
~/.claude/skills/rest-api/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rest-api/
Вручную: положить файлы
.cursor/skills/rest-api/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins rest-api2Вручную: положить файлы
.github/skills/rest-api/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/rest-apiВручную: положить файлы
.devin/skills/rest-api/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о build-zoom-rest-api-app
Как установить build-zoom-rest-api-app в Codex?
Выполните команду npx skills add openai/plugins --skill rest-api -a codex. Также спецификацию можно сохранить вручную в файл .agents/skills/rest-api/SKILL.md.
Что делает скилл build-zoom-rest-api-app?
Он инструктирует агента по вызову REST API Zoom, выбору правильных OAuth-потоков, проверке вебхуков и обработке лимитов.
Когда можно использовать Server-to-Server OAuth?
Скилл требует применять Server-to-Server OAuth только для эндпоинтов, где такой тип авторизации прямо заявлен в документации Zoom. Для пользовательских ресурсов нужен User-level OAuth.
Исходный текст
SKILL.md · MIT
--- name: build-zoom-rest-api-app description: Use when calling REST APIs. --- # Build Zoom REST API App Use this skill when the task needs deterministic Zoom API calls or resource management from application code. ## Workflow 1. Define the resource and actor: user, meeting, webinar, recording, docs, chat, phone, account, or admin-level workflow. 2. Select the endpoint and required scopes from the reference files before coding. 3. Confirm auth fit: user-level OAuth for user-owned resources, account-level OAuth for admin workflows, and only use server-to-server OAuth where the target API documents support for it. 4. Implement narrow API wrappers with explicit pagination, retry, idempotency, and rate-limit handling. 5. Treat webhook processing as a separate event-ingestion path with signature verification and replay protection. 6. Debug by checking token audience, missing scopes, resource ownership, account settings, API enablement, and rate-limit headers. ## References - Full preserved guide: [references/full-guide.md](references/full-guide.md) - API architecture: [concepts/api-architecture.md](concepts/api-architecture.md) - Authentication flows: [concepts/authentication-flows.md](concepts/authentication-flows.md) - Rate limits: [references/rate-limits.md](references/rate-limits.md) - Meetings: [references/meetings.md](references/meetings.md) - Recordings: [references/recordings.md](references/recordings.md) - Users: [references/users.md](references/users.md) - Token and scope playbook: [troubleshooting/token-scope-playbook.md](troubleshooting/token-scope-playbook.md)
© Zoom · MIT · openai/plugins
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — build-zoom-rest-api-app от других авторов.