EZF SERVICE · WEB MASTER
Entwicklung & Integration

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 ↗
01 / VERBINDUNG

Zentrale verbinden

HTTP oder HTTPS, optional mit Port. Keine Zugangsdaten.
Sekunden pro Antwort

Vier GET-Endpunkte ohne Request-Body, Token oder Cookies. Abfragen erfolgen nacheinander. HTTP-Erfolg und Anlagenzustand werden getrennt bewertet.

Bereit. Noch keine Abfrage gesendet.Automatisches Auslesen aus
02 / JSON

Systemstatus

GET/data/systeminfo.php
Noch keine Daten.
Quelle: —
Endpunkt öffnen ↗
HTTP-Anfrage / cURL
Rohantwort (JSON)
Keine Daten.
HTTP-Metadaten
Keine Daten.
03 / TSV

Leuchtenliste

GET/lumlist.php
Noch keine Daten.
Quelle: —
Endpunkt öffnen ↗
HTTP-Anfrage / cURL
Rohantwort (TSV)
Keine Daten.
HTTP-Metadaten
Keine Daten.
GES-V2 / FIRMWARE 10.27

Fehlerwörterbuch

GET/data/errorcodes.php
Noch keine Daten.
Quelle: —
Endpunkt öffnen ↗
HTTP-Anfrage / cURL
Rohantwort JSON
Keine Daten.
HTTP-Metadaten
Keine Daten.
GES-V2 / FIRMWARE 10.27

Einzelleuchtendiagnose

GET/data/luminaire.php?id=…Aus der TSV-Liste übernehmen oder eine Leuchte in der Tabelle anklicken.
Noch keine Daten.
Quelle: —
Endpunkt öffnen ↗
HTTP-Anfrage / cURL
Rohantwort JSON
Keine Daten.
HTTP-Metadaten
Keine Daten.
04 / LEUCHTEN

Adressen und Zustände

ID / Kanal / AdresseFehlercodeGerätetypGruppeÜberwachungBS / DSBetriebszeitLetzte TestdauerOrtAktualisiert
05 / OFFLINE

Beispiele & Dateien

Lokale Beispieldaten, keine Verbindung zur Zentrale. Die Beispiele sind keine Abnahme eines realen Geräts.

Maximal 2 MiB pro Antwort.
06 / DIAGNOSE

Abfrageprotokoll

Noch keine Einträge.

Bevor Sie integrieren

Firmware 10.27 verwendet 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.