Fluvigil Karte

API-Dokumentation

Alle Pegeldaten als JSON über eine REST-API: Stationen, Zeitreihen, Hochwasserlage und Wetter. Basis-URL: https://fluvigil.de/api/v1 — maschinenlesbare Spezifikation unter /openapi.yaml (OpenAPI 3.1).

Authentifizierung & Limits

Die API ist ohne Anmeldung nutzbar — anonym gelten die Free-Limits pro IP-Adresse (600 Requests/Stunde, 90 Tage Historie). Mit einem API-Key aus dem Konto gelten die Limits deines Tarifs — Details auf Tarife & Limits.

Der Key wird als Header X-Api-Key: pm_… oder Authorization: Bearer pm_… mitgeschickt. Bei überschrittenem Stundenbudget antwortet die API mit Status 429; ungültige Parameter liefern 400, unbekannte Stationen 404.

Stations-IDs sind quellen-namespaced: pegelonline:<uuid> für Bundeswasserstraßen, lhp:<id> für Landespegel.

GET
/stations
Stationsliste mit Filtern

Liefert bis zu 5.000 Stationen mit Stammdaten, aktuellem Wasserstand und Hochwasserklasse. Alle Filter sind kombinierbar.

Query-Parameter

  • q — Teilstring-Suche in Stationsname oder Gewässer
  • state — Bundesland-ISO-Code, z. B. DE-BY (nur Landespegel)
  • source — pegelonline oder lhp
  • floodClass — Mindest-Hochwasserklasse (-1 bis 4)
  • condition — Quellübergreifender Zustand: low, normal, flood oder flood-1 … flood-4 (exakte Klasse)
  • threshold — Aktueller Wert relativ zu Kennwerten: above-m3, above-m2, above-m1, above-mhw, above-mw, below-mnw
  • bbox — Kartenausschnitt "Süd,West,Nord,Ost" in WGS84
  • includeInactive — true, um inaktive Stationen einzuschließen
curl https://fluvigil.de/api/v1/stations?q=Dresden&source=pegelonline
GET
/stations/{id}
Stationsdetails

Stammdaten einer Station inklusive Betreiber, Fluss-Kilometer, Pegelnullpunkt und letztem Messwert.

curl https://fluvigil.de/api/v1/stations/lhp:SN_550810
GET
/stations/{id}/readings
Wasserstand-Zeitreihe

Messwerte in cm, zeitlich aufsteigend. Ohne Parameter die letzten 7 Tage; der maximale Zeitraum pro Abfrage richtet sich nach dem Tarif (anonym/Free: 90 Tage) — ältere from-Werte werden auf das Fenster gekürzt, vollständig außerhalb liegende Zeiträume liefern 400.

Query-Parameter

  • from — Beginn als ISO-8601-Zeitstempel
  • to — Ende als ISO-8601-Zeitstempel
curl https://fluvigil.de/api/v1/stations/lhp:SN_550810/readings?from=2026-06-01T00:00:00Z
GET
/stations/{id}/weather
Wettervorhersage am Standort

7-Tage-Prognose (Tagesaggregate) des Deutschen Wetterdienstes via Bright Sky, serverseitig 30 Minuten gecacht. Antwort enthält die Pflicht-Attribution.

curl https://fluvigil.de/api/v1/stations/lhp:SN_550810/weather
GET
/stats
Datensatz-Statistik

Aggregierte Zahlen: Stationen je Quelle, gespeicherte Messwerte mit ältestem/neuestem Zeitstempel, Kennwerte, Hochwasserklassen-Wechsel. 5 Minuten gecacht.

curl https://fluvigil.de/api/v1/stats
GET
/health
Service-Health

Erreichbarkeit der Datenbank und Aktualität der letzten Abrufe je Quelle — geeignet für Monitoring.

curl https://fluvigil.de/api/v1/health
Datenquellen & Attribution

Die Daten stammen aus PEGELONLINE (Wasserstraßen- und Schifffahrtsverwaltung des Bundes), dem Länderübergreifenden Hochwasserportal (CC BY 4.0 — bei Weiterverwendung ist die Quelle www.hochwasserzentralen.de zu nennen) und den Pegelportalen der Bundesländer; Wetterdaten vom Deutschen Wetterdienst via Bright Sky. Für LLM-Clients gibt es zusätzlich den MCP-Server.