Webhooks & HTTP-Aktionen – Externe Systeme steuern

Mit HTTP-Aktionen in LemonScore können Sie beliebige HTTP-Anfragen direkt aus Shortcuts auslösen. So steuern Sie externe Systeme wie OBS Studio, Heimautomation (z.B. Philips Hue), Webhooks oder andere REST-APIs — ohne zusätzliche Software.

HTTP-Aktion einrichten

1. Navigieren Sie zu Einstellungen → Shortcuts.
2. Erstellen oder bearbeiten Sie eine Shortcut-Karte.
3. Wählen Sie einen Slot und klicken Sie auf Aktion hinzufügen.
4. Wählen Sie die Kategorie HTTP und die Aktion HTTP Request.
5. Konfigurieren Sie die Anfrage:

• Methode — GET, POST, PUT, PATCH oder DELETE.
• URL — Die Ziel-URL (nur http:// und https:// werden unterstützt).
• Headers — Optionale HTTP-Header (z.B. Content-Type: application/json oder Authentifizierungs-Token).
• Body — Anfrage-Body für POST, PUT und PATCH (z.B. JSON-Daten).
• Timeout — Maximale Wartezeit in Millisekunden (Standard: 5000, Maximum: 30000).

Anwendungsbeispiele

OBS Studio steuern — Senden Sie Befehle an die OBS WebSocket API, um Szenen zu wechseln oder die Aufnahme zu starten:

• Methode: POST, URL: http://localhost:4455, Body: JSON-Befehl

Heimautomation — Schalten Sie Licht oder Effekte über Ihre Smart-Home-API:

• Methode: PUT, URL: http://192.168.1.10/api/lights/1/state, Body: {"on": true}

Webhook-Dienste — Lösen Sie IFTTT, Zapier oder eigene Webhooks aus:

• Methode: POST, URL: Ihre Webhook-URL

Aktionen verketten

HTTP-Aktionen lassen sich mit anderen Shortcut-Aktionen in einer Sequenz kombinieren. Zum Beispiel:

1. Schritt 1 — Animation abspielen (Tor)
2. Schritt 2 — HTTP POST an OBS (Kamera-Wechsel)
3. Schritt 3 — Musik starten (Torhymne)

Jede Aktion kann mit einer optionalen Verzögerung versehen werden, um das Timing zu steuern.

Tipps und Hinweise

• Timeout beachten — Setzen Sie den Timeout niedrig (z.B. 2000 ms), wenn das Zielsystem im lokalen Netzwerk erreichbar ist. So blockiert eine fehlgeschlagene Anfrage die Sequenz nicht lange.
• Fehlertoleranz — Eine fehlgeschlagene HTTP-Anfrage stoppt die Shortcut-Sequenz nicht. Die nächste Aktion wird normal fortgesetzt.
• Sicherheit — Nur HTTP und HTTPS sind als Protokolle erlaubt. Lokale Dateipfade oder andere Protokolle werden aus Sicherheitsgründen blockiert.