1. API-Key beantragen
Für die Nutzung der API benötigst du einen persönlichen API-Key.
API-Key beantragen2. Einzelnen Messwert abrufen
Beispiel: aktuelle Temperatur als JSON:
https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&key=DEIN_API_KEY
Antwort:
{
"field": "temperature",
"value": 21.7,
"unit": "°C",
"measured_at": "2026-05-02 14:35:00"
}
3. Nur Zahlenwert für Smarthome
Für Home Assistant, ioBroker, Node-RED oder Mikrocontroller kannst du nur den Zahlenwert abrufen:
https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&format=raw&key=DEIN_API_KEY
Antwort:
21.7
4. Du bist Anfänger? Kein Problem, API-URL Schritt für Schritt zusammenbauen
Eine API-URL besteht aus mehreren Teilen. Du kannst damit genau festlegen, welchen Messwert du abrufen möchtest und in welchem Format die Antwort kommen soll.
Schritt 1: Basis-Adresse
Diese Adresse bleibt immer gleich:
https://eifel-wetter.de/wetter-api/api/value.php
Schritt 2: Fragezeichen anhängen
Nach der Basis-Adresse kommt ein Fragezeichen:
https://eifel-wetter.de/wetter-api/api/value.php?
Schritt 3: Messwert auswählen
Mit field= wählst du den gewünschten Messwert aus. Siehe Tabelle 'verfügbare Messwerte' unten.
Beispiel Temperatur:
field=temperature
Die URL sieht dann so aus:
https://eifel-wetter.de/wetter-api/api/value.php?field=temperature
Schritt 4: API-Key anhängen
Danach kommt ein & und dein persönlicher API-Key:
&key=DEIN_API_KEY
Komplette JSON-URL:
https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&key=DEIN_API_KEY
Schritt 5: Nur den Zahlenwert abrufen
Für Smarthome-Systeme ist oft nur der reine Wert sinnvoll.
Dafür hängst du zusätzlich &format=raw an:
https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&format=raw&key=DEIN_API_KEY
Wichtig
- Der erste Parameter beginnt immer mit
? - Alle weiteren Parameter werden mit
&angehängt fieldbestimmt den Messwertformat=rawliefert nur den Wert ohne JSONkeyist dein persönlicher API-Key
Beispiele
Temperatur als reiner Wert:
https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&format=raw&key=DEIN_API_KEY
Luftfeuchtigkeit als JSON:
https://eifel-wetter.de/wetter-api/api/value.php?field=humidity&key=DEIN_API_KEY
Regensensor als Textwert:
https://eifel-wetter.de/wetter-api/api/value.php?field=rain_status&format=raw&key=DEIN_API_KEY
👉 Wichtig: DEIN_API_KEY ist nur ein Platzhalter und muss durch deinen echten Schlüssel ersetzt werden.
Was ist ein API-Key?
Der API-Key ist dein persönlicher Zugangsschlüssel zur Wetter API. Er stellt sicher, dass nur berechtigte Nutzer die Daten abrufen können.
Jeder API-Key ist eindeutig und sieht zum Beispiel so aus:
5920374fd564ba560013a94781d774a4b0f28b52bae0507934b0f5bd96338b0c
Das ist eine lange Zeichenkette aus Zahlen und Buchstaben, die du bei jeder Anfrage mitschicken musst.
Wie bekomme ich einen API-Key?
- Du stellst einen Antrag über das Formular auf dieser Seite
- Der Administrator prüft deine Anfrage
- Nach Freischaltung kannst du die API nutzen
- Du bekommst den API-Key per Mail und zwei fertige Links direkt zum Testen.
Bei Fragen zum API-Key sende einfach eine Mail.
Wichtig
- Dein API-Key ist persönlich – gib ihn nicht öffentlich weiter
- Missbrauch kann zur Sperrung führen
- Jede Anfrage an die API benötigt diesen Schlüssel
5. Verfügbare Messwerte
Außenwerte
- temperature Temperatur in °C
- humidity Luftfeuchtigkeit in %
- dew_point Taupunkt in °C
- wet_bulb Feuchtkugeltemperatur in °C
- heat_index Hitzeindex in °C
- wind_chill Windchill in °C
- thw_index Temperatur-Feuchte-Wind-Index in °C
Wind
- wind_speed aktuelle Windgeschwindigkeit in km/h
- wind_direction Windrichtung in °
- wind_direction_smooth geglättete Windrichtung in °
- wind_speed_avg_1min Windmittel 1 Minute in km/h
- wind_direction_avg_1min Windrichtung 1 Minute in °
- wind_speed_avg_2min Windmittel 2 Minuten in km/h
- wind_direction_avg_2min Windrichtung 2 Minuten in °
- wind_speed_hi_2min stärkste Böe 2 Minuten in km/h
- wind_direction_hi_2min Richtung stärkste Böe 2 Minuten in °
- wind_speed_avg_10min Windmittel 10 Minuten in km/h
- wind_direction_avg_10min Windrichtung 10 Minuten in °
- wind_speed_hi_10min stärkste Böe 10 Minuten in km/h
- wind_direction_hi_10min Richtung stärkste Böe 10 Minuten in °
Regen
- rain_rate aktuelle Regenrate in mm/h
- rain_rate_hi höchste Regenrate in mm/h
- rainfall_15min Regenmenge letzte 15 Minuten in mm
- rain_rate_hi_15min höchste Regenrate letzte 15 Minuten in mm/h
- rainfall_60min Regenmenge letzte 60 Minuten in mm
- rainfall_24h Regenmenge letzte 24 Stunden in mm
- rainfall_daily Regenmenge heute in mm
- rainfall_monthly Regenmenge aktueller Monat in mm
- rainfall_year Regenmenge aktuelles Jahr in mm
- rain_storm Regenmenge aktuelles Regenereignis in mm
- rain_storm_start Start aktuelles Regenereignis
- rain_storm_last letztes Regenereignis in mm
- rain_storm_last_start Start letztes Regenereignis
- rain_storm_last_end Ende letztes Regenereignis
- rain_status Regensensor als Text, z. B. trocken/Regen
- rain_sensor_raw Rohwert des Regensensors
Innenwerte
- temperature_inside Innentemperatur in °C
- humidity_inside Innen-Luftfeuchtigkeit in %
- dew_point_inside Innen-Taupunkt in °C
- heat_index_inside Innen-Hitzeindex in °C
Luftdruck
- pressure Luftdruck auf Meereshöhe in hPa
- pressure_absolute absoluter Luftdruck in hPa
- pressure_trend Luftdrucktrend
Statuswerte
- battery_status Batteriestatus / Senderstatus
- error Fehlerstatus
- brightness Helligkeit als Textwert
6.1. Beispiel für ioBroker
In ioBroker kannst du die Wetter API z. B. über den Adapter simple-api, javascript oder HTTP Request einbinden.
Variante: JavaScript Adapter
// URL zur API
const url = "https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&format=raw&key=DEIN_API_KEY";
fetch(url)
.then(res => res.text())
.then(value => {
setState("0_userdata.0.wetter.temperature", parseFloat(value), true);
});
Der Wert wird dabei in einen Datenpunkt geschrieben und kann in Visualisierungen oder Automationen verwendet werden.
Alternative: JSON verwenden
const url = "https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&key=DEIN_API_KEY";
fetch(url)
.then(res => res.json())
.then(data => {
setState("0_userdata.0.wetter.temperature", data.value, true);
});
6.2. Beispiel für Home Assistant
sensor:
- platform: rest
name: Eifel Wetter Temperatur
resource: "https://eifel-wetter.de/wetter-api/api/value.php?field=temperature&format=raw&key=DEIN_API_KEY"
unit_of_measurement: "°C"
value_template: "{{ value }}"
6.3. Beispiel: Markisensteuerung bei starkem Wind
Mit der Wetter API kannst du deine Markise automatisch einfahren lassen, wenn der Wind zu stark wird.
Prinzip
- Die API liefert die aktuelle Windgeschwindigkeit
- Dein Smarthome-System prüft regelmäßig den Wert
- Bei zu starkem Wind wird die Markise eingefahren
API-Aufruf
https://eifel-wetter.de/wetter-api/api/value.php?field=wind_speed&format=raw&key=DEIN_API_KEY
Beispiel-Rückgabe:
32.5
Logik (Beispiel)
Wenn Windgeschwindigkeit > 30 km/h
→ Markise einfahren
Beispiel in Pseudocode
wind = API_Wert
if (wind > 30) {
Markise = EINFAHREN
}
Beispiel für ioBroker (JavaScript)
const url = "https://eifel-wetter.de/wetter-api/api/value.php?field=wind_speed&format=raw&key=DEIN_API_KEY";
fetch(url)
.then(res => res.text())
.then(value => {
const wind = parseFloat(value);
if (wind > 30) {
setState("markise.einfahren", true);
}
});
Hinweise
- Typische Schwelle: 25–40 km/h (je nach Markise)
- Abfrageintervall: ca. alle 60 Sekunden
- Optional: Verzögerung einbauen, um unnötiges Ein-/Ausfahren zu vermeiden
7. Praktische Anwendungsfälle
Mit der Wetter API lassen sich viele Automationen und Anwendungen umsetzen. Hier sind einige typische Beispiele:
🌬️ Markise schützen (Wind)
Wenn wind_speed > 30 km/h
→ Markise einfahren
🌧️ Regen erkennen
Wenn rain_status = "Regen"
→ Fenster schließen
→ Markise einfahren
☀️ Beschattung automatisch steuern
Wenn brightness hoch UND temperature > 25°C
→ Rollläden oder Markise ausfahren
❄️ Frostwarnung
Wenn temperature < 0°C
→ Frostwarnung senden
→ Heizung aktivieren (z. B. Gartenleitungen schützen)
💧 Bewässerung steuern
Wenn rainfall_24h < 2 mm UND temperature > 20°C
→ Gartenbewässerung starten
🌡️ Lüften optimieren
Wenn temperature_inside > temperature
→ Fenster öffnen (automatisch oder Hinweis)
🚗 Glättewarnung für Einfahrt
Wenn temperature < 2°C UND humidity > 90%
→ Warnung: Glatteisgefahr
🌪️ Sturmwarnung
Wenn wind_speed_hi_10min > 50 km/h
→ Push-Nachricht senden
→ Außenbereiche sichern
📊 Eigene Wetteranzeige bauen
Temperatur + Luftfeuchtigkeit + Druck
→ eigene Webseite oder Dashboard anzeigen
8. Hinweise
- Der API-Key darf nicht öffentlich weitergegeben werden.
- Die Daten werden regelmäßig aktualisiert.
- Bitte keine unnötig häufigen Abfragen senden.
- Für Smarthome reicht meist eine Abfrage alle 60 Sekunden.