SCHNITTSTELLE · VERSION 1

MBCT3 Die Lage API

Die API stellt aktuelle und historische Lagebilder sowie die gespeicherten Kartenebenen in einem stabilen JSON-Format bereit. Sie ist ausschließlich lesend und ruft beim Zugriff keine externen Datenanbieter auf.

PDF-Dokumentation herunterladen OpenAPI 3.1 öffnen

BASIS-URLhttps://lage.mbct3.org/api/v1Read-only · JSON · HTTPS

Für Datenendpunkte ist ein persönlicher API-Schlüssel mit dem Scope lage:read erforderlich.

01 · ZUGANG

Authentifizierung

Übermittle den Schlüssel vorzugsweise als Bearer-Token. Alternativ wird der Header X-API-Key akzeptiert. API-Schlüssel gehören ausschließlich in eine serverseitige Konfiguration und niemals in öffentlich ausgeliefertes Browser-JavaScript.

Authorization: Bearer <API_KEY>

02 · SCHNELLSTART

Erste Anfrage

Mit diesem Aufruf wird das aktuelle Lagebild einschließlich der drei priorisierten Themen abgerufen.

curl -H "Authorization: Bearer <API_KEY>" \
  https://lage.mbct3.org/api/v1/lage/latest

ENDPUNKTE

Verfügbare Daten

Alle geschützten Endpunkte benötigen den Scope lage:read.

GET /status

Dienststatus, jüngster Lagezeitpunkt und technische Stände der Kartenebenen.

GET /lage/latest

Aktuelles Gesamtsignal, Zusammenfassung, Quellenanzahl und drei priorisierte Themen.

GET /topics

Aktive oder alle Themen; filterbar nach Ampelwert und begrenzbar mit limit.

GET /topics/{key}

Stammdaten und zeitlicher Verlauf eines Themas einschließlich Quellen.

GET /history

Historische Lagebilder mit cursorbasierter Fortsetzung über before.

GET /layers

Kompakter Status aller fünf Kartenebenen.

GET /layers/{layer}

Gespeicherte Daten für weather, water, traffic, wildfire oder air.

DATENSTAND

Zeit und Status

data_updated_at benennt den fachlichen Datenstand, generated_at den Zeitpunkt der Antwort. Kartenlayer können live, stale oder unavailable sein.

EFFIZIENZ

Cache und Limits

Antworten enthalten ETag und nach Möglichkeit Last-Modified. Mit If-None-Match sind 304-Antworten möglich. Je Schlüssel gelten 120 Anfragen pro Minute.

VERANTWORTUNG

Nutzung und Quellen

Das Angebot ist kein amtliches Warnsystem. Datenstand, MBCT3 als Quelle und die verknüpften Originalquellen müssen erkennbar bleiben. Rechte und Bedingungen der Datenanbieter gelten fort.

Technische Referenz und rechtliche Hinweise

Feldtypen, Parameter, Antwortschemata und Fehlercodes stehen vollständig in der OpenAPI-Beschreibung und in der PDF-Dokumentation. Ergänzend gelten die Quellenhinweise und die Nutzungs- und Datenschutzinformationen.