Developers

API Documentation

The oneDOMUS Weather API delivers current weather data as JSON, ready to use as a Virtual HTTP Input in Loxone Config. All values are also available individually as plain text.

Ready-to-use Loxone Config template

Download the template, replace YOUR_API_TOKEN with your own token and import via Loxone Config → right-click in Peripherals → Import template. All 13 inputs will be created immediately — no further settings needed.

Already have an active licence? Log in and download the file with your token pre-filled from your miniserver page.

Download — Dutch Download — English Download — German

Getting started

Installation in Loxone Config

Step by step from portal to working weather data

Part 1 — Portal

Click on your Miniserver to open the detail page. Then click Show token to reveal your API token.

Scroll to API token & Loxone URL and click Download XML — EN. The file already contains your token.

Your token is already filled in the downloaded file. No changes needed before continuing in Loxone Config.

Part 2 — Loxone Config

Open Loxone Config and connect to your Miniserver.

In the Peripherals panel, navigate to your Miniserver and click Virtual inputs.

Click Predefined… in the toolbar at the top.

Choose Import template… from the dropdown menu.

Navigate to the downloaded XML file and click Open.

The file is in your <em>Downloads</em> folder by default and is named <em>weerbericht-loxone-en.xml</em>.

Click Predefined… again. The template now appears under My templates. Click the name to create the inputs.

A message appears: "Please note that only general addresses have been entered…". Click OK.

Ignore this message if you downloaded the file from the portal — your token is already correctly filled in. This message appears by default for every template.

Done! All 13 virtual inputs have been created under your Miniserver. You can now use them on any page in Loxone Config.

Authentication

Every request requires an API token. Retrieve it via Dashboard → Miniserver → Show token. Pass it as a query parameter or 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

Returns all weather values in a single JSON object. Recommended for use in Loxone — one request, all inputs.

Request

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 }

Individual text endpoints

Each field is also available individually as plain text (text/plain).

Endpoint	Field	Unit	Example response
`/temperature`	Outside temperature	°C	`18.4`
`/precipitation`	Precipitation	mm/h	`0.4`
`/humidity`	Humidity	%	`68`
`/windspeed`	Wind speed	km/h	`14.4`

Weather data fields

Endpoint	Unit	Range	Description
`timestamp`	ISO 8601	—	Measurement timestamp
`location_lat`	°	−90 – 90	Latitude of the configured location
`location_lon`	°	−180 – 180	Longitude of the configured location
`temperature_c`	°C	−40 – +50	Current outdoor temperature at 2 metres
`feels_like_c`	°C	−50 – +60	Apparent temperature (wind chill / heat index)
`humidity_pct`	%	0 – 100	Relative humidity
`precipitation_mm`	mm/h	0 – ~100	Total precipitation (rain + snow), current
`rain_mm`	mm/h	0 – ~100	Rainfall only
`snowfall_cm`	cm/h	0 – ~20	Snowfall
`cloud_cover_pct`	%	0 – 100	Cloud cover — 0 = clear, 100 = fully overcast
`wind_speed_kmh`	km/h	0 – ~150	Wind speed at 10 metres
`wind_direction_deg`	°	0 – 360	Wind direction — 0/360°=N, 90°=E, 180°=S, 270°=W
`wind_gusts_kmh`	km/h	0 – ~200	Wind gusts at 10 metres
`weather_code`	WMO	—	Numeric weather code (WMO, see table below)
`is_raining`	0/1	0 – 1	1 when `precipitation_mm` > 0
`is_snowing`	0/1	0 – 1	1 when `snowfall_cm` > 0

WMO Weather Codes (`weather_code`)

Clear & cloudy

0	Clear sky
1	Mainly clear
2	Partly cloudy
3	Overcast

Fog

45	Fog
48	Depositing rime fog

Drizzle

51	Light drizzle
53	Moderate drizzle
55	Dense drizzle

Rain

61	Slight rain
63	Moderate rain
65	Heavy rain

Showers

80	Slight showers
81	Moderate showers
82	Violent showers

Snow

71	Slight snow
73	Moderate snow
75	Heavy snow
77	Snow grains
85	Snow showers
86	Heavy snow showers

Thunderstorm

95	Thunderstorm
96	Thunderstorm with hail
99	Thunderstorm with heavy hail

HTTP Status Codes

Code	Meaning
200	Success — the value is in the response body
401	Missing or invalid token
402	Licence expired — renew via the portal
502	Weather data temporarily unavailable — try again

Caching & refresh

Weather data is refreshed every minute. The XML template is already configured correctly — import it and your Loxone Miniserver is ready to go.