Доступ к 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]/organization— базовые данные организации.GET /v1/[org]/channels— список каналов со статусом и видимостью.GET /v1/[org]/sessions— эфиры с фильтрами по статусу и периоду.GET /v1/[org]/questions— входящие Q&A со статусом.GET /v1/[org]/announcements— объявления из текущих и прошлых эфиров.GET /v1/[org]/reactions— агрегированные счётчики реакций по типу.GET /v1/[org]/analytics/overview— обзор статистики организации.
- 04
Rate limits
В каждом ответе есть заголовок
X-RateLimit-Remainingс остатком квоты. При превышении API отвечает429 Too Many Requestsи заголовкомRetry-After. - 05
Полный справочник
Интерактивный справочник со всеми endpoints, query-параметрами и response-схемами:
Открыть справочник API