Informationen zur API

Kurzbeschreibung

---

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.