ioBroker.awekas

Dieser Adapter bindet die AWEKAS Wetterdaten-API in ioBroker ein und stellt aktuelle Messwerte, Tageswerte, Stundenwerte sowie – sofern verfügbar – Vorhersagedaten als States zur Verfügung.

Der Adapter ist lesend und greift periodisch auf die AWEKAS API (current.php) zu.

Voraussetzungen

• ioBroker ≥ aktueller LTS
• Node.js ≥ 18
• AWEKAS Benutzerkonto
• AWEKAS API-Key (AWEKAS Plus erforderlich)

Installation

Über GitHub (empfohlen)

iobroker url https://github.com/delfser/ioBroker.awekas

oder über die Admin-Oberfläche → Adapter → GitHub / Octocat.

Konfiguration

Die Konfiguration erfolgt über die Adapter-Instanz.

Parameter
Feld	Beschreibung
AWEKAS API-Key	Persönlicher API-Key aus dem AWEKAS Benutzerprofil
Abfrageintervall (Sekunden)	Polling-Intervall für API-Abfragen (Minimum: 10 s)
Sprache	Sprache der API-Antwort (de / en)

Hinweis:
Der von AWEKAS bereitgestellte API-Key kann URL-encodiert sein.
Der Adapter erkennt dies automatisch und verarbeitet beide Formate korrekt.

Gelieferte States
Status
awekas.0.info.connection   (boolean)
awekas.0.info.lastFetch    (timestamp)
awekas.0.info.lastError    (string)

Aktuelle Wetterdaten (current.*)

Alle von AWEKAS gelieferten Felder werden automatisch als States angelegt, z. B.:

current.temperature
current.humidity
current.airpress_rel
current.windspeed
current.gustspeed
current.winddirection
current.precipitation
current.rainrate
current.uv
current.solar

Tageswerte (day.*)
day.temp_min
day.temp_max
day.precipitation

Stundenwerte (1h.*)
1h.precipitation_1h

Vorhersage (forecast.*)

Falls von der API geliefert:

forecast.0.*
forecast.1.*
...
forecast.count
forecast.json


forecast.json enthält die vollständige Vorhersage als JSON-String

Die Anzahl der Forecast-Einträge ist standardmäßig auf 10 begrenzt

Verhalten bei Fehlern

Bei API-Fehlern oder ungültigem Key:

info.connection = false

info.lastError wird gesetzt

Bei erfolgreicher Abfrage:

info.connection = true

info.lastFetch aktualisiert

Der Adapter verwendet ein Timeout von 10 Sekunden pro API-Request.

Icon

Der Adapter verwendet ein generisches Wetterstations-Icon ohne Markenbezug.
Es bestehen keine Abhängigkeiten oder Rechte an AWEKAS-Markenzeichen.

Haftungsausschluss

Dieser Adapter steht in keiner offiziellen Verbindung zur AWEKAS GmbH.
AWEKAS ist eine eingetragene Marke der jeweiligen Rechteinhaber.

Die Nutzung der AWEKAS-API unterliegt den jeweils gültigen Nutzungsbedingungen von AWEKAS.

## Changelog

### 0.1.0
- Initial release

## License

MIT License


Changelog
0.1.0

Initial Release

Anbindung der AWEKAS API (current.php)

Unterstützung für current, day, 1h und forecast

Automatische State-Erstellung

Robustes Error-Handling