IRL-Relay per Webhook fernsteuern

Ihr Relay lässt sich über den Aufruf einer Adresse starten, stoppen oder neu starten. So geht das aus SAMMI, Streamer.bot, Bitfocus Companion oder per Knopfdruck auf einem Stream Deck.

Typischer Fall: Sie haben mehrere Relays, zum Beispiel eines zu Hause und eines im Rechenzentrum, und es soll immer nur eines aktiv sein. Sonst schaltet NOALBS die Szenen doppelt, und Chatbefehle wie !start oder !stop werden zweimal ausgeführt.

Wo die Adressen stehen

Im Kundenportal unter Streaming das Relay öffnen, in der Karte Relay-Fernsteuerung (Webhook) auf Webhook-Adressen erzeugen klicken. Sie erhalten fünf Adressen, eine je Aktion, in dieser Form:

https://vcontrol.glowfish.de:9786/api/v1/relay/IHR-SCHLÜSSEL/aktion

Die fünf Aktionen

• start: schaltet die Dienste des Relays ein.
• stop: stoppt das Relay. Alle Dienste werden beendet (SRT, SRTLA, RIST, NOALBS und der Chat-Bot), eine laufende Sendung bricht ab. Das Relay ist dann gestoppt und wartet auf start.
• neustart: startet alle Dienste neu.
• allein: schaltet dieses Relay ein und stoppt alle anderen Relays Ihres Kundenkontos.
• status: gibt nur Auskunft und ändert nichts.

Aufruf und Antwort

Die Adresse wird mit GET oder POST aufgerufen, ohne weitere Daten. Die Aktion wirkt binnen fünf Sekunden. Die Antwort kommt als JSON, zum Beispiel:

{"ok":true,"relay":"relay-0001","name":"Relay Zuhause","zustand":"aktiv","sendet":false,"letzte_meldung":"11.11.2026 07:30:12"}

Bei einem unbekannten Schlüssel antwortet die Adresse mit dem Status 404. Je Relay sind höchstens 30 Aufrufe pro Minute möglich.

Self-Hosted-Relay

Bei einem Relay auf Ihrem eigenen Server läuft nach dem Stoppen nur ein kleiner Steuerprozess im Container weiter, der auf start wartet. Einen Zugang zu Docker auf Ihrem Server brauchen Sie dafür nicht.

Einrichtung in gängigen Programmen

• SAMMI: Befehl „HTTP Request“, Methode GET, als URL die Webhook-Adresse.
• Streamer.bot: Sub-Action „Fetch URL“ mit der Webhook-Adresse.
• Bitfocus Companion: Modul „Generic: HTTP Requests“, Aktion GET mit der Webhook-Adresse.
• Stream Deck: ein Plugin für Webanfragen, zum Beispiel „API Ready“, Methode GET.

Zwischen zwei Relays umschalten: Legen Sie zwei Knöpfe an, jeder mit der Adresse allein des jeweiligen Relays. Ein Druck schaltet das gewählte Relay ein und stoppt das andere.

Sicherheit

Wer die Adresse kennt, kann Ihr Relay steuern. Behandeln Sie sie wie ein Kennwort und zeigen Sie sie nie im Stream. Bei Verdacht klicken Sie im Kundenportal auf Neue Webhook-Adressen erzeugen. Die alten Adressen gelten dann sofort nicht mehr.

Zusätzlich lässt sich der Aufruf auf bestimmte Adressen beschränken: In der Karte Relay-Fernsteuerung (Webhook) unter Nur von bestimmten Adressen erlauben (optional) tragen Sie im Feld Erlaubte IP-Adressen oder Netze einzelne IPv4- oder IPv6-Adressen oder Netze mit Präfix ein, mit Komma getrennt, zum Beispiel 203.0.113.7, 198.51.100.0/24. Bleibt das Feld leer, ist der Aufruf von überall möglich. Aufrufe von anderen Adressen weist das Relay mit dem Status 403 ab („Aufruf von dieser Adresse nicht erlaubt“).

Wechselt die IP-Adresse Ihres Anschlusses, etwa zu Hause, passt eine Einzeladresse nur bis zum nächsten Wechsel. Tragen Sie dann besser das Netz Ihres Anbieters ein oder lassen Sie das Feld leer.

Wie Sie das Relay einrichten und den Stream in OBS empfangen, steht unter IRL-Streaming einrichten.