Ontwikkelaars

API-documentatie

De oneDOMUS Weerbericht API levert actuele weerdata als JSON, direct bruikbaar als Virtual HTTP Input in Loxone Config. Alle waarden worden ook afzonderlijk aangeboden als platte tekst.

Kant-en-klaar Loxone Config sjabloon

Download het sjabloon, vervang JOUW_API_TOKEN door je eigen token en importeer via Loxone Config → rechtermuisknop in Peripherals → Sjabloon importeren. Alle 13 ingangen worden direct aangemaakt — geen verdere instellingen nodig.

Heb je al een actieve licentie? Log dan in en download het bestand met je token al ingevuld vanuit je miniserver-pagina.

Downloaden — Nederlands Download — English Herunterladen — Deutsch

Aan de slag

Installatie in Loxone Config

Stap voor stap van portaal tot werkende weerdata

Deel 1 — Portaal

Klik op je miniserver om de detailpagina te openen. Klik daarna op Toon token om je API-token zichtbaar te maken.

Scroll naar API-token & Loxone URL en klik op XML downloaden — NL (of EN). Het bestand bevat je token al correct ingevuld.

Je token staat al ingevuld in het gedownloade bestand. Je hoeft niets aan te passen voor je verdergaat in Loxone Config.

Deel 2 — Loxone Config

Open Loxone Config en verbind met je miniserver.

Ga in het Randapparatuur paneel naar je miniserver en klik op Virtuele ingangen.

Klik op Vooraf gedefinieerd… in de werkbalk bovenaan.

Kies Template importeren… in het dropdown menu.

Navigeer naar het gedownloade XML-bestand en klik op Openen.

Het bestand staat standaard in je map Downloads en heeft de naam weerbericht-loxone-nl.xml (of -en.xml voor de Engelse versie).

Klik opnieuw op Vooraf gedefinieerd…. Het sjabloon staat nu onder Mijn templates. Klik op de naam om de ingangen aan te maken.

Er verschijnt een melding "Let wel op dat alleen algemene adressen zijn ingegeven…". Klik op OK.

Negeer deze melding als je het bestand via het portaal hebt gedownload — je token staat al correct ingevuld en het adres klopt. De melding verschijnt standaard bij elk sjabloon.

Klaar! De 13 virtuele ingangen zijn aangemaakt onder je miniserver. Je kunt ze nu op elke pagina in Loxone Config gebruiken.

Authenticatie

Elke aanroep vereist een API-token. Haal het op via Dashboard → Miniserver → Toon token. Stuur het mee via query parameter of X-Api-Key header.

Query parameter

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

Header

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

Endpoints

GET /?key=your_token · application/json

Retourneert alle weerwaarden in één JSON-object. Aanbevolen voor gebruik in Loxone — één aanroep, alle ingangen.

Aanroep

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 }

Losse tekst-endpoints

Elk veld is ook afzonderlijk opvraagbaar als platte tekst (text/plain).

Endpoint	Veld	Eenheid	Voorbeeld response
`/temperature`	Buitentemperatuur	°C	`18.4`
`/precipitation`	Neerslag	mm/h	`0.4`
`/humidity`	Luchtvochtigheid	%	`68`
`/windspeed`	Windsnelheid	km/h	`14.4`

Weerdata velden

Endpoint	Eenheid	Bereik	Omschrijving
`timestamp`	ISO 8601	—	Tijdstip van de meting
`location_lat`	°	−90 – 90	Breedtegraad van de geconfigureerde locatie
`location_lon`	°	−180 – 180	Lengtegraad van de geconfigureerde locatie
`temperature_c`	°C	−40 – +50	Actuele buitentemperatuur op 2 meter hoogte
`feels_like_c`	°C	−50 – +60	Gevoelstemperatuur (wind chill / hitte-index)
`humidity_pct`	%	0 – 100	Relatieve luchtvochtigheid
`precipitation_mm`	mm/h	0 – ~100	Totale neerslag (regen + sneeuw), actueel
`rain_mm`	mm/h	0 – ~100	Regenval alleen
`snowfall_cm`	cm/h	0 – ~20	Sneeuwval
`cloud_cover_pct`	%	0 – 100	Bewolkingsgraad — 0 = helder, 100 = volledig bewolkt
`wind_speed_kmh`	km/h	0 – ~150	Windsnelheid op 10 meter hoogte
`wind_direction_deg`	°	0 – 360	Windrichting — 0/360°=N, 90°=O, 180°=Z, 270°=W
`wind_gusts_kmh`	km/h	0 – ~200	Windstoten op 10 meter hoogte
`weather_code`	WMO	—	Numerieke weercode (zie tabel hieronder)
`is_raining`	0/1	0 – 1	1 zodra `precipitation_mm` > 0
`is_snowing`	0/1	0 – 1	1 zodra `snowfall_cm` > 0

WMO Weercodes (`weather_code`)

Helder & bewolkt

0	Helder
1	Overwegend helder
2	Gedeeltelijk bewolkt
3	Bewolkt

Mist

45	Mist
48	IJsmist

Motregen

51	Lichte motregen
53	Matige motregen
55	Dichte motregen

Regen

61	Lichte regen
63	Matige regen
65	Zware regen

Buien

80	Lichte buien
81	Matige buien
82	Zware buien

Sneeuw

71	Lichte sneeuw
73	Matige sneeuw
75	Zware sneeuw
77	Sneeuwkorrels
85	Sneeuwbuien
86	Zware sneeuwbuien

Onweer

95	Onweer
96	Onweer met hagel
99	Zwaar onweer met hagel

HTTP-statuscodes

Code	Betekenis
200	Succes — de waarde staat in de response body
401	Ontbrekend of ongeldig token
402	Licentie verlopen — verleng via het portaal
502	Weerdata tijdelijk niet beschikbaar — probeer opnieuw

Caching & verversing

De weerdata wordt elke minuut ververst. Het XML-sjabloon staat al correct ingesteld — importeer het en je Loxone miniserver is direct klaar.