Piloter le relais IRL par webhook

Votre relais peut être démarré, arrêté ou redémarré en appelant une adresse. Cela fonctionne depuis SAMMI, Streamer.bot, Bitfocus Companion ou d'une pression de touche sur un Stream Deck.

Cas typique : vous avez plusieurs relais, par exemple un à domicile et un au centre de données, et un seul doit être actif à la fois. Sinon, NOALBS change de scène deux fois et les commandes de chat comme !start ou !stop sont exécutées deux fois.

Où trouver les adresses

Dans l'espace client, ouvrez le relais sous Streaming et cliquez sur Générer les adresses webhook dans la carte Commande à distance du relay (webhook). Vous obtenez cinq adresses, une par action, sous cette forme :

https://vcontrol.glowfish.de:9786/api/v1/relay/VOTRE-CLÉ/action

Les cinq actions

• start: active les services du relais.
• stop: arrête le relais. Tous les services sont arrêtés (SRT, SRTLA, RIST, NOALBS et le bot de chat), une diffusion en cours s'interrompt. Le relais est alors arrêté et attend start.
• neustart: redémarre tous les services.
• allein: active ce relais et arrête tous les autres relais de votre compte client.
• status: donne seulement des informations et ne modifie rien.

Appel et réponse

L'adresse est appelée en GET ou POST, sans autres données. L'action prend effet en cinq secondes. La réponse est au format JSON, par exemple :

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

Avec une clé inconnue, l'adresse répond avec le statut 404. Au maximum 30 appels par minute sont possibles par relais.

Relais self-hosted

Avec un relais sur votre propre serveur, seul un petit processus de contrôle continue de tourner dans le conteneur après l'arrêt, en attendant start. Aucun accès à Docker sur votre serveur n'est nécessaire.

Configuration dans les programmes courants

• SAMMI: Commande « HTTP Request », méthode GET, avec l'adresse webhook comme URL.
• Streamer.bot: Sous-action « Fetch URL » avec l'adresse webhook.
• Bitfocus Companion: Module « Generic: HTTP Requests », action GET avec l'adresse webhook.
• Stream Deck: un plugin pour les requêtes web, par exemple « API Ready », méthode GET.

Basculer entre deux relais : créez deux boutons, chacun avec l'adresse allein du relais correspondant. Une pression active le relais choisi et arrête l'autre.

Sécurité

Quiconque connaît l'adresse peut piloter votre relais. Traitez-la comme un mot de passe et ne la montrez jamais dans le stream. En cas de doute, cliquez sur Générer de nouvelles adresses webhook dans l'espace client. Les anciennes adresses ne fonctionnent plus immédiatement.

Vous pouvez aussi limiter l'appel à certaines adresses : dans la carte Commande à distance du relay (webhook), sous Autoriser uniquement certaines adresses (facultatif), saisissez dans le champ Adresses IP ou réseaux autorisés des adresses IPv4 ou IPv6 ou des réseaux avec préfixe, séparés par des virgules, par exemple 203.0.113.7, 198.51.100.0/24. Si le champ reste vide, l'appel est possible de partout. Le relais refuse les appels provenant d'autres adresses avec le statut 403 (« Appel depuis cette adresse non autorisé »).

Si l'adresse IP de votre connexion change, par exemple à domicile, une adresse unique ne convient que jusqu'au prochain changement. Indiquez alors plutôt le réseau de votre fournisseur ou laissez le champ vide.

La configuration du relais et la réception du stream dans OBS sont décrites sous Configurer le streaming IRL.