Ihre Zentrale.
Die Schnittstelle im Blick.
Web-Master-API prüfen, Antworten analysieren und die Anbindung vorbereiten. Für reale Zentralen und den mitgelieferten lokalen Simulator.
Integrationshandbuch öffnen ↗Zentrale verbinden
Vier GET-Endpunkte ohne Request-Body, Token oder Cookies. Abfragen erfolgen nacheinander. HTTP-Erfolg und Anlagenzustand werden getrennt bewertet.
Systemstatus
GET/data/systeminfo.phpHTTP-Anfrage / cURL
Rohantwort (JSON)
Keine Daten.
HTTP-Metadaten
Keine Daten.
Leuchtenliste
GET/lumlist.phpHTTP-Anfrage / cURL
Rohantwort (TSV)
Keine Daten.
HTTP-Metadaten
Keine Daten.
Fehlerwörterbuch
GET/data/errorcodes.phpHTTP-Anfrage / cURL
Rohantwort JSON
Keine Daten.
HTTP-Metadaten
Keine Daten.
Einzelleuchtendiagnose
GET/data/luminaire.php?id=…Aus der TSV-Liste übernehmen oder eine Leuchte in der Tabelle anklicken.HTTP-Anfrage / cURL
Rohantwort JSON
Keine Daten.
HTTP-Metadaten
Keine Daten.
Adressen und Zustände
| ID / Kanal / Adresse | Fehlercode | Gerätetyp | Gruppe | Überwachung | BS / DS | Betriebszeit | Letzte Testdauer | Ort | Aktualisiert |
|---|
Beispiele & Dateien
Lokale Beispieldaten, keine Verbindung zur Zentrale. Die Beispiele sind keine Abnahme eines realen Geräts.
Maximal 2 MiB pro Antwort.Abfrageprotokoll
Bevor Sie integrieren
ges-v2: Kanal und physische Adresse bilden gemeinsam die ID. Fehlerwörterbuch und Einzelleuchtendiagnose sind verfügbar. Testdauer und Aktualisierungsdatum bleiben optional leer. Das API enthält keine Schreib- oder Startbefehle für Tests.Verbindung, CORS und HTTPS
Bei einem Netzwerkfehler den Endpunkt zuerst direkt öffnen. Prüfen Sie IP, Port, Zertifikat, CORS und die Browserfreigabe für das lokale Netzwerk. Ein „Failed to fetch“ identifiziert die Ursache nicht eindeutig. HTTPS-Seiten können HTTP-Abfragen blockieren. Der Tester deaktiviert keine TLS-Prüfung und folgt keinen Weiterleitungen.
Bevorzugt den Tester über den Simulator unter http://127.0.0.1:8765/ öffnen. Alternativ: python3 -m http.server 8080 --bind 127.0.0.1 im Paketordner. Das umgeht keine CORS- oder TLS-Regeln.
JSON-Anfragen und Seriennummer
Die bestätigten Endpunkte erwarten GET ohne JSON-Body. JSON-Request-Beispiele im Handbuch sind strukturierte Beschreibungen der HTTP-Anfrage, kein an die Zentrale zu sendender Body. Die Leuchtenliste wird als TSV übertragen.
Der aktuelle Systemstatus enthält keine bestätigte Seriennummer. Der Simulator ergänzt serial_number und simulator=true; diese Felder sind ausschließlich Simulator-Erweiterungen. Ein echter SN-Endpunkt wird hier nicht erfunden.