Webhooks & API-Schlüssel

StageTick ermöglicht Pro- und Enterprise-Nutzern die Integration mit externen Diensten über Webhooks und eine REST-API. Verwalten Sie Webhooks in den Organisationseinstellungen und API-Schlüssel im Menü jedes Raums.

Pro+-Funktion: Webhooks und API-Schlüssel sind in den Pro- und Enterprise-Plänen verfügbar. Siehe Pläne & Limits für Details.

Webhooks

Webhooks ermöglichen es StageTick, Echtzeit-Ereignisbenachrichtigungen an Ihren Server zu senden. Wenn etwas in einem Raum passiert, sendet StageTick eine HTTP-POST-Anfrage an die von Ihnen konfigurierte URL.

Unterstützte Ereignisse

Ereignis Beschreibung
room.on_air Wird ausgelöst, wenn ein Raum auf Sendung geht (Wiedergabe startet)
room.off_air Wird ausgelöst, wenn ein Raum die Sendung beendet (Wiedergabe stoppt)
timer.started Wird ausgelöst, wenn ein Timer startet
timer.finished Wird ausgelöst, wenn ein Timer null erreicht

Webhooks verwalten

Um Webhooks zu erstellen, anzuzeigen oder zu löschen, gehen Sie zu Organisationseinstellungen im Kontomenü.

  1. Öffnen Sie das Kontomenü und wählen Sie Organisationseinstellungen.
  2. Scrollen Sie zum Abschnitt Webhooks.
  3. Klicken Sie auf Webhook hinzufügen, geben Sie die Ziel-URL ein und wählen Sie die Ereignisse aus, die Sie abonnieren möchten.
  4. Nach der Erstellung wird das Signatur-Geheimnis einmalig angezeigt. Kopieren und speichern Sie es sicher — es kann danach nicht erneut angezeigt werden.
Wichtig: Das Signatur-Geheimnis wird nur einmal bei der Erstellung des Webhooks angezeigt. Verwenden Sie es, um zu überprüfen, dass eingehende Anfragen tatsächlich von StageTick stammen.

Limits

  • Pro: bis zu 5 Webhooks pro Organisation
  • Enterprise: bis zu 20 Webhooks pro Organisation

API-Schlüssel

API-Schlüssel ermöglichen den programmatischen Zugriff auf Raumdaten über die StageTick REST-API. Jeder Schlüssel ist auf einen einzelnen Raum beschränkt und hat eine Berechtigungsstufe.

Berechtigungen

  • read — Lesezugriff auf Raumdaten (Timer, Transport-Status, Nachrichten, Fragen)
  • readwrite — Vollzugriff zum Lesen und Ändern von Raumdaten

API-Schlüssel verwalten

Um API-Schlüssel zu erstellen, anzuzeigen oder zu widerrufen, öffnen Sie das Raummenü des Raums, den Sie integrieren möchten.

  1. Öffnen Sie einen Raum und klicken Sie auf das Raummenü (Drei-Punkte-Symbol oder Raumeinstellungen).
  2. Wählen Sie API-Schlüssel.
  3. Klicken Sie auf API-Schlüssel erstellen, wählen Sie eine Berechtigung (read oder readwrite) und fügen Sie optional eine Bezeichnung hinzu.
  4. Der Schlüssel wird nach der Erstellung einmalig angezeigt. Kopieren und speichern Sie ihn sicher — er kann danach nicht erneut angezeigt werden.
  5. Um einen Schlüssel zu widerrufen, klicken Sie auf die Löschen-Schaltfläche daneben. Widerrufene Schlüssel funktionieren sofort nicht mehr.
Wichtig: Der API-Schlüsselwert wird nur einmal bei der Erstellung angezeigt. Wenn Sie ihn verlieren, widerrufen Sie den alten Schlüssel und erstellen Sie einen neuen.

Limits

  • Pro: bis zu 5 API-Schlüssel pro Raum
  • Enterprise: bis zu 20 API-Schlüssel pro Raum