Erster Lauf
- Schritt 1
Öffnen Sie Developer Integrations und überprüfen Sie die aktuell verfügbaren Bereiche.
- Schritt 2
Erstellen Sie ein Token nur für die Vorgänge, die Sie benötigen.
- Schritt 3
Verwenden Sie die im Dashboard angezeigten Beispiele und Datenformate. Behalten Sie den Cursor beim Lesen von Ereignissen bei.
- Schritt 4
Behandeln Sie Unterbrechungen, Wiederholungsversuche und keine neuen Ereignisse. Widerrufen Sie einen Token, den Sie nicht mehr benötigen.
Broadcast-Beispiel
Ihr eigenes Tool ruft nachfolgende Ereignisse ab, ohne denselben Verlauf mehrmals zu verarbeiten. Mit dem Cursor können Sie von der letzten Position aus fortfahren, und die begrenzten Bereiche des Tokens schränken seine Berechtigungen ein.
Aktion und Möglichkeiten
Schlüssel mit Bereichen
Erstellen Sie in Integrationen einen Schlüssel mit separaten Berechtigungen für LIVE-Status, Ereignisse, Timer oder Musikwarteschlange. Wir zeigen den Schlüssel nur einmal. Wählen Sie eine Gültigkeit von 7, 30 oder 90 Tagen; Sie können es jederzeit widerrufen.
Lesen und Cursor
Übergeben Sie den Schlüssel im Header „Authorization: Bearer“. Beim Lesen von Ereignissen wird der Nach-Cursor verwendet, wodurch die Automatisierung alte Nachrichten nicht wiederholt. Die erste Lesung ohne Cursor beginnt ab dem aktuellen Zeitpunkt. Das Auslesen beschränkt sich auf die Daten des Schlüsseleigentümers.
Beispiel und Dokumentation
Laden Sie die OpenAPI 3.1-Beschreibung und das JavaScript-Beispiel auf Ihren eigenen Server, Node-RED oder eine andere Automatisierungsumgebung herunter. Senden Sie jeweils eine Anfrage, empfohlen alle zwei Sekunden, mit einem Limit von 60 Anfragen pro Minute. Platzieren Sie den Schlüssel nicht im öffentlichen HTML-Code oder in der Overlay-Adresse.
Sehen Sie sich die Schnittstelle aus nächster Nähe an
Klicken Sie auf die Abbildung, um sie zu vergrößern. Die Screenshots zeigen verschiedene Teile des Setups; In der Überschrift wird erklärt, worauf Sie achten müssen.
Wenn etwas nicht funktioniert
Der Anfrage wird der Zugriff verweigert
Überprüfen Sie das Token und den erforderlichen Bereich. Verwenden Sie die aktuelle Endpunktdokumentation und die richtige Anforderungsmethode.
Die gleichen Ereignisse wiederholen sich
Speichern Sie den zurückgegebenen Cursor und deduplizieren Sie die IDs. Beginnen Sie nicht jede Lektüre am Anfang der Geschichte.