RiverPulse API

REST-Zugriff auf Pegelstände von 665+ Stationen an deutschen Wasserstraßen. Verfügbar im Business-Plan; API-Keys verwaltest du in deinem Konto unter Warnungen & Konto.

Authentifizierung

Jeder Request trägt deinen Key als Bearer-Token. Keys beginnen mit rp_live_ und werden bei Erstellung genau einmal angezeigt.

curl -H "Authorization: Bearer rp_live_…" \
  https://riverpulse.bigdataheaven-software.de/api/v1/stations

Limit: 600 Requests/Stunde pro Key. Bei Überschreitung antwortet die API mit 429.

GET /api/v1/stations

Stationskatalog mit Lage, Fluss-Kilometer und Referenz-Pegelmarken (MNW/MW/MHW/HSW). Optionaler Filter ?river=Rhein.

{
  "count": 665,
  "stations": [
    {
      "id": "…", "name": "MAINZ", "river": "RHEIN", "km": 498.3,
      "latitude": 50.0, "longitude": 8.27,
      "mnw": 170, "mw": 310, "mhw": 520, "hsw": 630,
      "hasOfficialForecast": true
    }
  ]
}

GET /api/v1/stations/:id/measurements

Messwerte (cm) der letzten ?hours=48 Stunden (max. 720 = 30 Tage), chronologisch aufsteigend.

{
  "station": { "id": "…", "name": "MAINZ", "river": "RHEIN" },
  "hours": 48, "unit": "cm", "count": 192,
  "measurements": [
    { "timestamp": "2026-06-11T05:00:00Z", "value": 312, "trend": "rising", "source": "wsv" }
  ]
}

Fehler

• 401 — Key fehlt, ungültig oder widerrufen
• 403 — Business-Abo abgelaufen
• 429 — Rate-Limit erreicht

Fair Use & Quellen

Rohdatenquelle ist PEGELONLINE (WSV). Bitte nenne RiverPulse als Quelle, wenn du Daten weiterveröffentlichst. Fragen: [email protected]