Statische JSON-API

Basis-URL

https://coldfront.wi7.net/api/v1/

Aktueller Stand

Datenstand 13.10.2026, ausgegeben am 13.10.2026, Modell: ensemble-dyn-season-holiday. Die Prognose gilt für 17 Regionen.

Dateien

Regionen-Kennungen

Felder der Regionsdateien

Die Felder entsprechen den TypeScript-Schnittstellen des Pakets forecast-core. Diese Schnittstellen sind die verbindliche Beschreibung.

Quantile und Bänder

Jede Prognose ist eine Reihe von Quantilen. q50 ist der Median. Das 50-%-Band reicht von q25 bis q75, das 80-%-Band von q10 bis q90. Die Quantile sind aufsteigend sortiert. Die Bänder beschreiben die Unsicherheit des Modells; sie sind keine garantierten Grenzen.

Aktivitätsstufen

Der Index ist der Median der Prognose geteilt durch den Median der saisonalen Norm der Zielwoche. Ab 1,25 gilt die Stufe erhöht, ab 1,75 die Stufe hoch, darunter normal. Die Schwellen sind Startwerte und nicht empirisch geprüft.

Beispiele

curl -s "https://coldfront.wi7.net/api/v1/index.json"

const res = await fetch("https://coldfront.wi7.net/api/v1/regions/de-sn.json");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const forecast = await res.json();
for (const h of forecast.horizons) {
  console.log(h.iso_week, h.q25, h.q50, h.q75);
}

{
  "h": 1,
  "iso_week": "YYYY-Www",
  "q10": 0,
  "q25": 0,
  "q50": 0,
  "q75": 0,
  "q90": 0,
  "index": 0,
  "level": "normal"
}

Zugriff aus dem Browser (CORS)

Die Dateien werden mit dem Header Access-Control-Allow-Origin: * ausgeliefert. Browser-Anwendungen anderer Herkunft können sie deshalb direkt lesen.

Versionierung

Jede Prognosedatei trägt schema_version. Die aktuelle Version ist 1. Prüfen Sie diesen Wert, bevor Sie die Datei auswerten.

Nachnutzung und Nennung

Für den Programmcode ist noch keine Lizenz festgelegt. Die Daten behalten die Lizenz ihrer Quelle; Einzelheiten stehen unter Daten & Quellen. Prognosen sind eigene Berechnungen auf Basis dieser Daten und müssen entsprechend genannt werden. Verwenden Sie den folgenden Nennungstext:

Quelle: Robert Koch-Institut, Umweltbundesamt, Deutscher Wetterdienst; eigene Berechnung