Entwickler

API-Dokumentation

Die oneDOMUS Wetter-API liefert aktuelle Wetterdaten als JSON, direkt nutzbar als Virtual HTTP Input in Loxone Config. Alle Werte sind auch einzeln als Klartext verfügbar.

Fertiges Loxone Config-Template

Laden Sie das Template herunter, ersetzen Sie IHR_API_TOKEN durch Ihr eigenes Token und importieren Sie es über Loxone Config → Rechtsklick in Peripherie → Template importieren. Alle 13 Eingänge werden sofort erstellt — keine weiteren Einstellungen erforderlich.

Haben Sie bereits eine aktive Lizenz? Melden Sie sich an und laden Sie die Datei mit Ihrem bereits eingetragenen Token von Ihrer Miniserver-Seite herunter.

Herunterladen — Niederländisch Herunterladen — Englisch Herunterladen — Deutsch

Erste Schritte

Installation in Loxone Config

Schritt für Schritt vom Portal zu funktionierenden Wetterdaten

Teil 1 — Portal

Melden Sie sich im Portal an unter weerbericht.onedomus.nl/de/login. Noch kein Konto? Registrieren Sie zuerst Ihren Miniserver.

Klicken Sie auf Ihren Miniserver, um die Detailseite zu öffnen. Klicken Sie dann auf Token anzeigen, um Ihren API-Token sichtbar zu machen.

Scrollen Sie zu API-Token & Loxone-URL und klicken Sie auf XML herunterladen — DE. Die Datei enthält bereits Ihren Token.

Ihr Token ist bereits in der heruntergeladenen Datei eingetragen. Keine Anpassungen nötig, bevor Sie in Loxone Config weitermachen.

Teil 2 — Loxone Config

Öffnen Sie Loxone Config und verbinden Sie sich mit Ihrem Miniserver.

Navigieren Sie im Peripherie-Bereich zu Ihrem Miniserver und klicken Sie auf Virtuelle Eingänge.

Klicken Sie in der Symbolleiste oben auf Vordefiniert….

Wählen Sie im Dropdown-Menü Template importieren….

Navigieren Sie zur heruntergeladenen XML-Datei und klicken Sie auf Öffnen.

Die Datei befindet sich standardmäßig in Ihrem <em>Downloads</em>-Ordner und heißt <em>weerbericht-loxone-de.xml</em>.

Klicken Sie erneut auf Vordefiniert…. Das Template erscheint jetzt unter Meine Templates. Klicken Sie auf den Namen, um die Eingänge zu erstellen.

Es erscheint eine Meldung: "Bitte beachten Sie, dass nur allgemeine Adressen eingegeben wurden…". Klicken Sie auf OK.

Ignorieren Sie diese Meldung, wenn Sie die Datei aus dem Portal heruntergeladen haben — Ihr Token ist bereits korrekt eingetragen. Diese Meldung erscheint standardmäßig bei jedem Template.

Fertig! Die 13 virtuellen Eingänge wurden unter Ihrem Miniserver erstellt. Sie können sie jetzt auf jeder Seite in Loxone Config verwenden.

Authentifizierung

Jede Anfrage erfordert einen API-Token. Holen Sie ihn über Dashboard → Miniserver → Token anzeigen. Übergeben Sie ihn als Query-Parameter oder X-Api-Key-Header.

Query-Parameter

https://weerbericht.onedomus.nl/?key=your_token

Header

GET / HTTP/1.1
X-Api-Key: your_token

Endpunkte

GET /?key=your_token · application/json

Gibt alle Wetterwerte in einem einzigen JSON-Objekt zurück. Empfohlen für Loxone — eine Anfrage, alle Eingänge.

Anfrage

https://weerbericht.onedomus.nl/?key=your_token

Response (application/json)

{ "timestamp": "2025-06-25T10:00:00Z", "location_lat": 52.3676, "location_lon": 4.9041, "temperature_c": 18.4, "feels_like_c": 17.1, "humidity_pct": 68, "precipitation_mm": 0, "rain_mm": 0, "snowfall_cm": 0, "cloud_cover_pct": 25, "wind_speed_kmh": 14.4, "wind_direction_deg": 270, "wind_gusts_kmh": 22.0, "weather_code": 2, "is_raining": 0, "is_snowing": 0 }

Einzelne Text-Endpunkte

Jedes Feld ist auch einzeln als Klartext (text/plain) abrufbar.

Endpunkt	Feld	Einheit	Beispiel-Response
`/temperature`	Außentemperatur	°C	`18.4`
`/precipitation`	Niederschlag	mm/h	`0.4`
`/humidity`	Luftfeuchtigkeit	%	`68`
`/windspeed`	Windgeschwindigkeit	km/h	`14.4`

Wetterdaten-Felder

Endpunkt	Einheit	Bereich	Beschreibung
`timestamp`	ISO 8601	—	Zeitpunkt der Messung
`location_lat`	°	−90 – 90	Breitengrad des konfigurierten Standorts
`location_lon`	°	−180 – 180	Längengrad des konfigurierten Standorts
`temperature_c`	°C	−40 – +50	Aktuelle Außentemperatur in 2 Meter Höhe
`feels_like_c`	°C	−50 – +60	Gefühlte Temperatur (Windchill / Hitzeindex)
`humidity_pct`	%	0 – 100	Relative Luftfeuchtigkeit
`precipitation_mm`	mm/h	0 – ~100	Gesamtniederschlag (Regen + Schnee), aktuell
`rain_mm`	mm/h	0 – ~100	Nur Niederschlag als Regen
`snowfall_cm`	cm/h	0 – ~20	Schneefall
`cloud_cover_pct`	%	0 – 100	Bewölkungsgrad — 0 = klar, 100 = vollständig bedeckt
`wind_speed_kmh`	km/h	0 – ~150	Windgeschwindigkeit in 10 Meter Höhe
`wind_direction_deg`	°	0 – 360	Windrichtung — 0/360°=N, 90°=O, 180°=S, 270°=W
`wind_gusts_kmh`	km/h	0 – ~200	Windböen in 10 Meter Höhe
`weather_code`	WMO	—	Numerischer Wettercode (WMO, siehe Tabelle)
`is_raining`	0/1	0 – 1	1 wenn `precipitation_mm` > 0
`is_snowing`	0/1	0 – 1	1 wenn `snowfall_cm` > 0

WMO-Wettercodes (`weather_code`)

Heiter & bewölkt

0	Klarer Himmel
1	Überwiegend klar
2	Teilweise bewölkt
3	Bedeckt

Nebel

45	Nebel
48	Gefrierender Nebel

Nieselregen

51	Leichter Nieselregen
53	Mäßiger Nieselregen
55	Dichter Nieselregen

Regen

61	Leichter Regen
63	Mäßiger Regen
65	Starker Regen

Schauer

80	Leichte Schauer
81	Mäßige Schauer
82	Starke Schauer

Schnee

71	Leichter Schneefall
73	Mäßiger Schneefall
75	Starker Schneefall
77	Schneekörner
85	Schneeschauer
86	Starke Schneeschauer

Gewitter

95	Gewitter
96	Gewitter mit Hagel
99	Schweres Gewitter mit Hagel

HTTP-Statuscodes

Code	Bedeutung
200	Erfolg — der Wert befindet sich im Response-Body
401	Fehlender oder ungültiger Token
402	Lizenz abgelaufen — erneuern Sie sie über das Portal
502	Wetterdaten vorübergehend nicht verfügbar — bitte erneut versuchen

Caching & Aktualisierung

Die Wetterdaten werden jede Minute aktualisiert. Das XML-Template ist bereits korrekt konfiguriert — importieren Sie es und Ihr Loxone Miniserver ist sofort einsatzbereit.