Что это
Zoom API позволяет программе получать данные встреч и выполнять разрешенные операции в аккаунте Zoom. Он полезен для проверки расписания, связи встречи с CRM и передачи данных во внутренний процесс.
REST API не заменяет приложение видеосвязи или Meeting SDK. Чтение встречи также не гарантирует доступ к записи, транскрипту или AI-сводке: для них нужны отдельные возможности, разрешения и подходящие условия аккаунта.
Начните с списка запланированных встреч своего пользователя. Для внутренней серверной интеграции подходит Server-to-Server OAuth, для доступа от имени пользователей - соответствующий OAuth-процесс. Не переносите учетные данные и scopes из одного вида приложения в другой.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Встречи доступны в структурированном виде для сверки с другими системами.
- Есть отдельный Server-to-Server OAuth для собственной организации.
- Scopes позволяют ограничить доступ нужным типом операций.
- Webhooks помогают строить процесс вокруг событий вместо постоянного опроса.
Ограничения
- Создание приложения и выбор scopes требуют разрешений администратора.
- Права, лицензия и требования каждого метода проверяются отдельно.
- Список встреч пользователя не является полным архивом всех прошедших встреч.
- Записи, транскрипты и сведения об участниках требуют отдельной настройки и защиты данных.
Как использовать
1. Подготовка. Получите разрешение администратора своего Zoom-аккаунта. Подготовьте ID или email своего пользователя и одну известную запланированную встречу. Выберите тест чтения, без создания встреч и рассылки приглашений.
2. Настройка. Создайте и активируйте Server-to-Server OAuth app с правом meeting:read:list_meetings:admin. Храните Account ID, Client ID и Client Secret на сервере. Получите токен через POST https://zoom.us/oauth/token: HTTP Basic для Client ID:Client Secret, тело application/x-www-form-urlencoded с grant_type=account_credentials и account_id=<Account ID>.
3. Первый результат. Выполните GET https://api.zoom.us/v2/users/<userId>/meetings с Authorization: Bearer <access_token>. Подставьте ID или URL-кодированный email пользователя своей организации; для выбранного серверного подключения не используйте me. Из meetings получите id, topic и время известных встреч.
4. Проверка. Сверьте одну встречу с кабинетом Zoom, включая часовой пояс. Учтите next_page_token при наличии следующих страниц; пустой список не доказывает отсутствие прошедших встреч. При 401 проверьте токен, при отказе доступа - scopes и пользователя. Получайте новый серверный токен по истечении expires_in; не включайте изменение встреч до отдельной проверки.
Примеры сценариев
- Сверить время известной встречи с календарем.
- Проверить доступ интеграции к своему пользователю.
- Передать только ID и тему встречи во внутреннюю задачу.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Доступность конкретных API зависит от прав и условий Zoom-аккаунта. Возможность проводить встречи не гарантирует доступ к отчетам, облачным записям или AI-сводкам. Наличие бесплатного доступа ко всем этим возможностям не подтверждено; перед запуском проверьте prerequisites каждого метода.
Когда не подходит
- Обещать транскрипт любой встречи по ее ID
- Собирать записи и контакты участников без разрешения
- Считать REST-метод возможностью подключиться к видеопотоку
Альтернативы
Google Calendar API и Microsoft Graph Calendar работают с календарями и подходят для расписания, но не заменяют доступ к записям Zoom. Microsoft Teams Bot Framework нужен для бота в Teams, а не прямой замены Zoom REST. Выбирайте альтернативу по своей платформе и конкретному результату.
