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] - Profil, Einstellungen und Plan der Organisation.
• GET /v1/[org]/team - Mitglieder der Organisation.
• GET /v1/[org]/subscription - Plan, Limits und KI-Finanzierung (Wallet oder BYOK).
• GET /v1/[org]/channels - Channel-Liste mit Status und Sichtbarkeit.
• GET /v1/[org]/channels/[channel]/sessions - Sendungen eines Channels, filterbar nach Status und Zeitraum.
• GET /v1/[org]/sessions/[id] - Session-Detail plus Sub-Ressourcen: questions, announcements, reactions, speakers, ai.

Die API erlaubt bis zu 300 Anfragen pro Minute und IP-Adresse. Bei Überschreitung antwortet die API mit 429 Too Many Requests und einem Retry-After-Header mit der Wartezeit in Sekunden.

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