Доступ к API
- 01
Создать API-токен
В
Организация → API-токенысоздаются токены для программного доступа к данным организации. На токен задаются:- Label для распознавания.
- Срок: 30, 90, 365 дней или без ограничения.
- Доступ: пока только чтение (read).
Внимание
Токены показываются один раз. Копируйте сразу после создания. Максимум 5 активных токенов на организацию. - 02
Аутентификация
Токены передаются в заголовке
Authorization:curl https://api.openbooth.io/v1/[orgSlug]/channels \ -H "Authorization: Bearer obk_..."
Пути содержат org-slug:
/v1/[orgSlug]/[resource]. - 03
Ключевые endpoints
GET /v1/[org]- профиль, настройки и план организации.GET /v1/[org]/team- участники организации.GET /v1/[org]/subscription- план, лимиты и финансирование AI (кошелёк или BYOK).GET /v1/[org]/channels- список каналов со статусом и видимостью.GET /v1/[org]/channels/[channel]/sessions- эфиры канала с фильтрами по статусу и периоду.GET /v1/[org]/sessions/[id]- детали эфира и под-ресурсы: questions, announcements, reactions, speakers, ai.
- 04
Rate limits
API допускает до 300 запросов в минуту на один IP-адрес. При превышении API отвечает
429 Too Many Requestsи заголовкомRetry-Afterс временем ожидания в секундах. - 05
Полный справочник
Интерактивный справочник со всеми endpoints, query-параметрами и response-схемами:
Открыть справочник API