Integration
Schnittstelle statt Zettelwirtschaft.
Die Local API nimmt SSID, Passwort und Gültigkeit per HTTPS entgegen. Damit binden Sie den Hub in vorhandene Abläufe ein.
Zwei Schritte, die zusammengehören
Passwort im WLAN-System ändern
Das erledigt Ihre Infrastruktur oder Ihr Skript. WELIQ führt diese Änderung nicht durch.
Daten an den Hub senden
Ein authentifizierter HTTPS-POST an die Local API. Der Hub zeigt den neuen QR-Code.
Reihenfolge und Fehler planen
Schlägt Schritt 2 fehl, steht kurz ein altes Passwort im Display. Prüfen Sie die Antwort der API und wiederholen Sie bei Bedarf.
Local API v1
Basis: https://<hub>/api/v1. Anmeldung per Bearer-Schlüssel, den Sie in der Weboberfläche erzeugen. Daten im Format JSON, UTF-8.
POST /wifisetzt SSID, Passwort und optional die GültigkeitPOST /linksetzt Weblink und ÜberschriftPOST /vcardsetzt die KontaktdatenGET /statusliefert den Gerätestatus
Unbekannte Felder lehnt der Hub ab. Die Zertifikatsprüfung sollten Sie nicht abschalten: Hinterlegen Sie das Zertifikat oder prüfen Sie den Fingerabdruck aus der Weboberfläche.
# WLAN-Zugang setzen (Platzhalter ersetzen)
curl -X POST https://<ADRESSE>/api/v1/wifi \
--cacert hub-zertifikat.pem \
-H "Authorization: Bearer weliq_<SCHLUESSEL>" \
-H "Content-Type: application/json" \
-d '{"ssid":"Besucher",
"password":"<PASSWORT>",
"valid_from":"2026-11-02",
"valid_until":"2026-11-08"}'Schlüssel und Passwörter gehören nicht in Logs oder die Shell-Historie.
Akku-Hubs und das Wake-Signal
Ein Akku-Hub schläft und ist nur im Aufwachfenster erreichbar. Damit Ihre Automatisierung den richtigen Moment kennt, kann der Hub beim Aufwachen einmal ein Signal senden:
- als UDP-Textzeile an eine IP und einen Port, zum Beispiel für einen virtuellen UDP-Eingang einer Gebäudesteuerung
- als HTTP(S)-POST mit JSON, zum Beispiel an Home Assistant oder Node-RED
Das Signal enthält keine Zugangsdaten. Ein nicht erreichbares Ziel hält den Hub nicht länger wach.
Anleitungen nach Plattform
Wir kennzeichnen offen, wie weit jede Anbindung ist. Eine Anbindung gilt erst als „Getestet“, wenn sie am echten System geprüft wurde.
| Plattform | Zweck | Stand |
|---|---|---|
| Home Assistant | Automatisierung und Wake-Signal-Empfang | In Entwicklung |
| UniFi Network | Passwort im Controller rotieren, Zugang an WELIQ übergeben | Konzept |
| Sophos Firewall | Passwortrotation automatisieren, Hub synchronisieren | Konzept |
| Fortinet FortiGate | Passwortänderung und Übergabe an den Hub | Konzept |
| PowerShell | Passwort erzeugen, ändern, an den Hub senden | Konzept |
| Python | Plattformunabhängiger Ablauf mit Prüfung | Konzept |
| PRTG und Checkmk | Überwachung des Hubs | In Planung |
Fertige Skripte oder eine Unterstützung einzelner Systeme sagen wir erst zu, wenn Schnittstelle und Test vorliegen. Fragen Sie gern nach Ihrem System.