API-Zugang

Unter Organisation → API-Tokens erzeugst du Tokens für den programmatischen Zugriff auf Org-Daten. Pro Token vergibst du:

• Label zur Wiedererkennung.
• Gültigkeit: 30, 90, 365 Tage oder unbegrenzt.
• Zugriff: aktuell ausschließlich lesend (read).

Tokens werden im Authorization-Header übergeben:

curl https://api.openbooth.io/v1/[orgSlug]/channels \
  -H "Authorization: Bearer obk_..."

Pfade enthalten den Org-Slug: /v1/[orgSlug]/[ressource].

• GET /v1/[org]/organization — Stammdaten der Organisation.
• GET /v1/[org]/channels — Channel-Liste mit Status und Sichtbarkeit.
• GET /v1/[org]/sessions — Sendungen mit Filtern nach Status und Zeitraum.
• GET /v1/[org]/questions — Q&A-Eingänge inkl. Status.
• GET /v1/[org]/announcements — Mitteilungen aus laufenden und vergangenen Sendungen.
• GET /v1/[org]/reactions — aggregierte Reactions-Zahlen pro Typ.
• GET /v1/[org]/analytics/overview — Statistik-Kennzahlen für die Organisation.

Jede Antwort enthält den Header X-RateLimit-Remaining mit der verbleibenden Quote. Bei Überschreitung antwortet die API mit 429 Too Many Requests und Retry-After-Header.

Die interaktive Referenz mit allen Endpoints, Query-Parametern und Response-Schemas: