Seminar FHEM HTTPMOD, Web-APIs und JSON

Inhaltsverzeichnis

1. Einordnung und Nutzen
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Seminarinhalte
6. Praxisübungen
7. Technische Arbeitsumgebung

Einordnung und Nutzen

Eine reproduzierbare HTTP-Anfrage wird zuerst fachlich verstanden und anschließend schrittweise in eine wartbare, validierte FHEM-Definition überführt.

Zielgruppe

FHEM-Anwender, Integratoren, Administratoren und Entwickler für HTTP- oder JSON-basierte Geräte.

Voraussetzungen

FHEM-Grundkenntnisse sowie elementares Verständnis von Netzwerk und strukturierten Daten.

Lernziele

Nach Abschluss des Seminars können die Teilnehmenden die folgenden Aufgaben systematisch bearbeiten:

• HTTP-Anfrage analysieren: Endpunkt, Methode, Parameter, Header und Body erfassen. Pollingintervall und Belastungsgrenzen bestimmen.
• HTTPMOD lesend konfigurieren: Device mit Endpunkt und Intervall anlegen. Fehlerantworten und veraltete Werte kennzeichnen.
• JSON verarbeiten: Objekte, Arrays und Schlüsselpfade zerlegen. Formatänderungen mit Referenzdaten erkennen.
• Set-Befehle erstellen: Zulässige Aktionen und Grenzwerte definieren. Doppelaktionen bei Timeout vermeiden.
• Sicherheit und Betrieb: Token und Kennwörter schützen. Regressionstests für Schnittstellenänderungen erstellen.

Seminarinhalte

Kapitel 1: HTTP-Anfrage analysieren

1. Schritt 1: Endpunkt, Methode, Parameter, Header und Body erfassen.
2. Schritt 2: Statuscodes und Antworttypen unterscheiden.
3. Schritt 3: Authentifizierung und Gültigkeit einordnen.
4. Schritt 4: Pollingintervall und Belastungsgrenzen bestimmen.

Kapitel 2: HTTPMOD lesend konfigurieren

1. Schritt 1: Device mit Endpunkt und Intervall anlegen.
2. Schritt 2: Verbindung, Statuscode und Rohantwort prüfen.
3. Schritt 3: Erstes Reading extrahieren.
4. Schritt 4: Mehrere Werte mit Einheiten abbilden.
5. Schritt 5: Fehlerantworten und veraltete Werte kennzeichnen.

Kapitel 3: JSON verarbeiten

1. Schritt 1: Objekte, Arrays und Schlüsselpfade zerlegen.
2. Schritt 2: Relevante Werte auswählen.
3. Schritt 3: Datentypen, Nullwerte und Listen behandeln.
4. Schritt 4: Verschachtelte Daten in flache Readings überführen.
5. Schritt 5: Formatänderungen mit Referenzdaten erkennen.

Kapitel 4: Set-Befehle erstellen

1. Schritt 1: Zulässige Aktionen und Grenzwerte definieren.
2. Schritt 2: Methode, Header und Body aufbauen.
3. Schritt 3: Eingaben validieren und codieren.
4. Schritt 4: Antwort und realen Zustand vergleichen.
5. Schritt 5: Doppelaktionen bei Timeout vermeiden.

Kapitel 5: Sicherheit und Betrieb

1. Schritt 1: Token und Kennwörter schützen.
2. Schritt 2: Tokenablauf als Zustand abbilden.
3. Schritt 3: Timeout und Wiederholungsabstand festlegen.
4. Schritt 4: Logs von Geheimnissen freihalten.
5. Schritt 5: Regressionstests für Schnittstellenänderungen erstellen.

Praxisübungen

• JSON-Antwort in Readings überführen
• Validierten Set-Befehl erstellen
• Timeout und Tokenablauf behandeln

Technische Arbeitsumgebung

Die Übungen erfolgen in einer getrennten FHEM-Trainingsumgebung mit vorbereiteten Testgeräten, simulierten Ereignissen und kontrollierten Schnittstellen. Änderungen werden nach jedem Arbeitsschritt geprüft, gespeichert und anhand definierter Testfälle abgenommen.