Informationen zur API

Letzte Aktualisierung: Montag, 15.10.2018

Kurzbeschreibung


Einfache REST API im JSON Format mit dem Reisewarnstatus der meisten Länder. Rückgabe der aktuellen Einschätzung auf Basis der vorliegenden Daten. Für einzelne Länder oder alle Länder zusammen. Weitere Informationen zur Herkunft der Daten auf der FAQ Seite. Die Daten werden einmal täglich aktualisiert und liegen ab 7.30 deutscher Zeit vor (Zeitzone Deutschland/Berlin). Die einmalige Abfrage der API pro Tag ist daher ausreichend.

Typ der API
REST JSON
Encoding
UTF-8
Sprache
DE & EN

Benötigen Sie die Daten für aller Länder, bietet es sich an, die API ohne Parameter aufzurufen. Sie erhalten dann eine Gesamtübersicht aller Länder im gleichen Detailgrad wie beim Länderaufruf.

Hinweis: auf der rein englischsprachigen Webseite Travel-Advisory.info biete ich auch eine kostenpflichtige API mit deutlich detaillierteren Daten an.

Aufruf der API

Endpunkt:
https://www.reisewarnung.net/api

Optionale Parameter: country
https://www.reisewarnung.net/api?country=DE
ISO 2 Letter Ländercode, z.B. DE für Deutschland. siehe auch Wikipedia Liste der Ländercodes

Beschreibung des Formats

Datenstruktur Datentyp Feldbeschreibung
api_status Array Allgemeine Infos zum Zustand der API und der Verarbeitung der Anfrage.
request Array Rückmeldung, was angefordert wurde.
item String (2) Dies ist das Land, das angefordert wurde
reply VarChar Rückmeldung zur Antwort (technisch)
code Integer Entspricht den HTTP Statuscodes. 200 bedeutet alles ok. 404 bedeutet, dass der Eintrag nicht gefunden wurde.
status VarChar Eine Beschreibung des HTTP Statuscodes.
count Integer Anzahl der Ergebnisse in [data]
data Array Hier sind die eigentlichen Ergebnisse enthalten. Gibt es nur ein Ergebnis (Aufruf mit Ländercode), so ist Data direkt mit den nachfolgenden Feldern befüllt. Wurden alle Länder angefordert, ist [data] ein Array aus Elementen wie unten beschreiben. Dabei ist der Schlüssel zum einzelnen Element der offizielle ISO Alpha 2 Ländercode.
code Array 2-Letter Codes für Länder und Kontinente
country String (2) ISO Alpha 2 Ländercode
continent String (2) 2 Letter Kontinent-Code
situation VarChar Beschreibung der Gefahreneinschätzung
sources Integer Anzahl entdeckter Quellen/Hinweise
rating Float Aktuelle Bewertung zwischen 0 (niedrige Gefahr) und 5 (hohe Gefahr)
updated Timestamp Letztes Update der Bewertung
lang Array Hier folgen sprachbezogene Informationen.
de Array Deutsch (es ist noch [en] für englisch verfügbar)
country VarChar Names des Landes
continent VarChar Name des Kontinents
continent_info VarChar Zusatzinfo Region des Kontinents
url_details VarChar URL des Länderbeitrages mit mehr Informationen oder zur Quellenangabe.
advice VarChar Kurze Zusammenfassung des Status in Sprache.
en Array ...
... ...

Beispielantwort für ein einzelnes Land

https://www.reisewarnung.net/api?country=DE

{

    "api_status": {
        "request": {
            "item": "de"
        },
        "reply": {
            "code": "200",
            "status": "ok",
            "note": "The api works, we could match requested country code.",
            "count": 1
        }
    },
    "data": {
        "code": {
            "country": "DE",
            "continent": "EU"
        },
        "situation": {
            "sources": 1,
            "rating": "2.0",
            "updated": "2016-06-15 07:18:21"
        },
        "lang": {
            "de": {
                "country": "Deutschland",
                "continent": "Europa",
                "continent_info": "Westeuropa",
                "url_details": "https://www.reisewarnung.net/deutschland",
                "advice": "Reisen nach Deutschland sind weitestgehend sicher."
            },
            "en": {
                "country": "Germany",
                "continent": "Europe",
                "continent_info": "Western Europe",
                "url_details": "https://www.reisewarnung.net/en/germany",
                "advice": "Travelling Germany is (relatively) safe."
            }
        }
    }

}
				

Nutzung

Die API ist für private und kommerzielle Angebote kostenlos und frei nutzbar. Wenn Sie die Daten in einer APP oder Webseite nutzen wollen, sollte die URL aus dem Feld "url_details" als Quellenangabe verwendet werden (wenn die Länder einzeln angezeigt werden). Dabei kann die am besten passende Sprache gewählt werden. Alternativ ist eine Nennung von Reisewarnung.net mit einem allgemeinen Verweis auf die Webseite ausreichend.

Es handelt sich hierbei um ein Privatprojekt. Für die Richtigkeit und Verfügbarkeit der API wird keine Gewährleistung übernommen. Bei Fragen finden Sie einige Antworten auf der FAQ Seite (Navigation) oder wenden sich an die im Impressum angegebene Adresse.