Public API

Travel RiskMap stellt zwei kostenlose Read-only-JSON-Endpoints bereit: aktuelle Warnstufen und ausführliche Sicherheitstexte des Auswärtigen Amts für 199 Länder — dieselben Daten, die auch die Risiko-Karte und die Länderseiten anzeigen. Kein API-Key nötig, CORS ist offen (direkt aus Browser-Apps nutzbar). Fair-Use-Limit: 300 Anfragen pro Stunde und IP-Adresse — für das empfohlene stündliche Abfragen mehr als genug.

Endpoints

GET/api/warnings

Aktuelle Warnstufen pro Land aus dem OpenData-Feed des Auswärtigen Amts. Aktualisierung zweimal täglich (gegen 06:00 und 12:00 UTC).

Antwort-Schema

{
  "lastUpdated": "2026-05-04T12:00:07.254Z",
  "source": "live",
  "count": 199,
  "data": {
    "TH": {
      "level": 0,
      "warning": false,
      "partialWarning": false,
      "countryName": "Thailand",
      "notice": true,
      "regions": { "TH-BD": 1 },
      "borderWarnings": { "MM": 2 }
    },
    ...
  }
}

Feld	Typ	Bedeutung
`level`	0–3	0 = kein besonderes Risiko · 1 = Einschränkungen in einzelnen Regionen · 2 = Teilreisewarnung · 3 = Reisewarnung — identisch mit der Legende der Risiko-Karte
`notice`	bool	Level 0, aber das Auswärtige Amt nennt trotzdem Besonderheiten (z.B. Wetter- oder Naturgefahren) — auf der Karte die hellgrüne „Hinweise"-Stufe
`regions`	object	ISO-3166-2-Code → Level 0–3 pro Bundesstaat/Provinz (z.B. `"TH-BD": 1`); nicht aufgeführte Regionen erben die Landes-Einstufung
`borderWarnings`	object	Nachbar-ISO2 → Level 1–3 (z.B. `"MM": 2` = Hinweis zum Grenzgebiet Richtung Myanmar)
`countryName`	string	Deutscher Ländername vom Auswärtigen Amt

GET/api/texts

Ausführliche Sicherheits- und Einreise-Texte pro Land, inklusive einem kurzen Lagebild-Satz (reasoning). Aktualisierung montags und mittwochs gegen 12:00 UTC.

Antwort-Schema

{
  "lastUpdated": "2026-05-04T12:00:07.254Z",
  "count": 195,
  "data": {
    "TH": {
      "level": 1,
      "security": "Punktuelle Hinweise zu Grenzgebieten…",
      "entry": "Reisepass mit 6 Monaten Restgültigkeit…",
      "regions": { "TH-BD": 1 },
      "borderWarnings": { "MM": 2 },
      "reasoning": "…",
      "autoBumped": false,
      "updatedAt": "2026-05-04T12:00:07.254Z"
    },
    ...
  }
}

Caching, Rate-Limit & Stabilität

Beide Endpoints senden Cache-Control: public, max-age=60 und einen ETag — wer mit If-None-Match anfragt, bekommt bei unveränderten Daten ein schlankes 304 statt der vollen Antwort. Die Daten ändern sich realistisch zweimal täglich (Warnstufen) bzw. zweimal pro Woche (Texte). Empfohlenes Abfrage-Intervall: stündlich oder seltener.

Rate-Limit: 300 Anfragen pro Stunde und IP-Adresse (beide Endpoints zusammen). Darüber antwortet der Server mit 429. Für reguläre Nutzung ist das Limit nicht spürbar.

Schema-Stabilität: Dokumentierte Felder bleiben erhalten und behalten ihre Bedeutung. Neue Felder können jederzeit hinzukommen — bitte unbekannte Felder tolerant ignorieren, statt strikt zu validieren.

Attribution & Lizenz

Datenherkunft

Die Daten stammen aus dem OpenData-Feed des Auswärtigen Amts der Bundesrepublik Deutschland und stehen unter der Datenlizenz Deutschland — Namensnennung — Version 2.0 (dl-de/by-2-0). Bei Verwendung bitte Auswärtiges Amt als Original-Quelle nennen.

Travel RiskMap als Aggregator

Die zusätzliche Klassifikation pro Region und Grenze ist eine Eigenleistung von Travel RiskMap (Methodik: siehe Über uns). Bei API-Nutzung bitten wir um eine sichtbare Attribution mit Verlinkung auf travelriskmap.de, z. B. „Daten via Travel RiskMap (Quelle: Auswärtiges Amt)" oder „Powered by Travel RiskMap".

Tipp: fertige Länderseiten verlinken

Wer keine eigene Darstellung bauen will, kann direkt auf unsere Länderseiten verlinken — z. B. travelriskmap.de/laender/thailand. Dort stehen Warnstufe, regionale Hinweise, Grenzhinweise und Einreise-Informationen stets aktuell.

Beispiel — Browser / curl

curl -s https://www.travelriskmap.de/api/warnings | jq '.data.TH'

curl -s https://www.travelriskmap.de/api/texts | jq '.data.TH.security'

Hinweis zur Verbindlichkeit

Diese API ersetzt keine offizielle Beratung. Verbindlich sind allein das Auswärtige Amt sowie die Botschaft oder das Konsulat des Reiselandes. Travel RiskMap übernimmt keine Gewähr für Aktualität, Vollständigkeit oder Richtigkeit und keine Haftung für Reise-Entscheidungen, die auf Basis dieser Daten getroffen werden.

Kontakt & Bug-Reports

Fehlermeldungen, Schema-Wünsche oder Fragen zu höherem Abruf-Volumen: hello@travelriskmap.de — weitere Angaben im Impressum.