# API-Quellen

## Zweck

Dieses Dokument beschreibt die Wetter- und Warnquellen, die von den Workflows verwendet werden.

## Geltungsbereich

Die Übersicht umfasst strukturierte API Quellen und fragile Webseitenquellen in den vorhandenen Workflow JSON Exporten.

## Strukturierte Quellen

### DWD ICON über Open-Meteo

Der Haupt-Workflow nutzt DWD ICON Daten über Open-Meteo. Diese Quelle liefert strukturierte Wetterwerte wie Temperatur, Niederschlag, Wettercode, Wind, Böen, Luftfeuchte, Bewölkung und UV-Index.

### Open-Meteo Standard Forecast

Open-Meteo Standard Forecast ergänzt insbesondere Niederschlagswahrscheinlichkeiten und weitere Prognosewerte.

### DWD Warnmeldungen

DWD Warnmeldungen werden als JSON abgerufen und zur Bewertung aktueller Wetterrisiken genutzt.

### NINA/BBK Warnungen

NINA/BBK Warnungen ergänzen die Warnlage für die konfigurierte Region.

### OpenWeatherMap

Der ältere Workflow `wetter-tagesprognose-n8n-workflow.json` nutzt OpenWeatherMap und benötigt einen API Key Platzhalter. Dieser Workflow ist eher als Legacy-Variante einzuordnen.

## Webseitenquellen

Einige Workflows prüfen zusätzlich Webseiten wie WetterOnline, wetter.com, Meteoblue, Weather.com, AccuWeather, DasWetter oder Kachelmannwetter.

Diese Quellen sind nicht so stabil wie strukturierte API Quellen, weil Webseiten Layouts ändern, Inhalte per JavaScript laden oder Cookie-Hinweise anzeigen können.

## Konfiguration

Quellen sind derzeit direkt in den Workflow Code Nodes konfiguriert. Bei Änderungen müssen URLs und Auswertung gemeinsam geprüft werden.

## Einschränkungen

- Webseitenprüfung ist Best-Effort.
- API Antworten können sich ändern.
- Externe Dienste können Rate Limits, Ausfälle oder Formatänderungen haben.
- OpenWeatherMap benötigt einen API Key und ist deshalb weniger einfach teilbar.

## Zusätzlich anbindbare Quellen (deutschsprachiger Raum, PLZ 38165)

Geprüfte Kandidaten für die Erweiterung, mit Integrationsweg (Details und Links in `docs/monitoring.md` bzw. auf der Monitoring-Seite):

- **DWD RADOLAN/Radar via Bright Sky** (`/radar?lat&lon`): Niederschlags-Nowcasting 0–2 h, ohne API-Key, direkt als n8n-HTTP-Node nutzbar.
- **DWD MOSMIX Einzelstation** (Open Data Server, z. B. Braunschweig): voller Parameterumfang statt interpolierter Auswahl.
- **DWD CAP-Warnfeed**: im Haupt-Workflow bereits als Adapter vorbereitet, noch zu aktivieren.
- **MeteoAlarm (EUMETNET)**: europaweiter amtlicher Warn-Zweitkanal (ATOM/CAP).
- **Meteostat**: lange Beobachtungshistorie für die Verifikation (API-Key nötig).
- **Weitere Open-Meteo-Modelle** (UKMO, Météo-France, JMA, GEM): zusätzliche unabhängige Konsensstimmen ohne API-Key, nur `models=`-Parameter ergänzen.
- **wetterdienst (Python)**: 10-Minuten-Stationswerte des DWD für feinere Verifikation.
- **GeoSphere Austria / MeteoSchweiz Open Data**: für eine DACH-Erweiterung über 38165 hinaus.
- **Kachelmannwetter / wetter.com API**: kommerzielle HD-Modelle als Option, falls freie Quellen nicht reichen.

## Zukünftige Verbesserungen

- Quellenstatus pro Workflow dokumentieren.
- Fallback-Verhalten genauer beschreiben.
- Beispielantworten als Test-Fixtures ergänzen.