Feed API – Kundenanleitung

Übersicht

Die Feed API stellt aktuelle Sicherheits- und Reiserisiko-Events sowie Länderinformationen als RSS/Atom-Feeds bereit. Die Feeds können in Feed-Reader, CMS-Systeme oder eigene Anwendungen eingebunden werden.

Keine Authentifizierung erforderlich – alle Feed-Endpunkte sind öffentlich zugänglich.

Base-URL

https://platform.passolution.de/feed

Die bisherige Adresse https://global-travel-monitor.eu/feed bleibt weiterhin gültig; bestehende Feed-Abonnements müssen nicht umgestellt werden.

Caching

Feed-Antworten werden serverseitig gecacht. Die Cache-Dauer beträgt standardmäßig 1 Stunde (3600 Sekunden). Bei neuen oder geänderten Events wird der Cache automatisch invalidiert.

Metadaten

Verfügbare Priorities und Event-Typen

GET /feed/events/meta.json

Gibt die gültigen Werte für Priority-Filter und Event-Typ-Filter als JSON zurück.

Beispiel:

bash
curl https://platform.passolution.de/feed/events/meta.json

Response:

json
{
  "priorities": [
    { "code": "high", "name_de": "Hoch", "name_en": "High" },
    { "code": "medium", "name_de": "Mittel", "name_en": "Medium" },
    { "code": "low", "name_de": "Niedrig", "name_en": "Low" },
    { "code": "info", "name_de": "Information", "name_en": "Info" }
  ],
  "event_categories": [
    {
      "code": "environment",
      "name": "Umweltereignisse",
      "description": "...",
      "icon": "fa-house-crack",
      "color": "#FF0000"
    }
  ]
}

Event-Feeds

Alle Event-Feeds liefern nur aktive, nicht-archivierte Events, deren Startdatum in der Vergangenheit liegt. Maximal 100 Events pro Feed, sortiert nach Startdatum (neueste zuerst).

Alle Events

Format URL
RSS 2.0 /feed/events/all.xml
Atom 1.0 /feed/events/all.atom

Beispiel:

bash
curl https://platform.passolution.de/feed/events/all.xml

Events nach Priorität

GET /feed/events/priority/{priority}.xml
Parameter Gültige Werte
priority high, medium, low, info

Beispiel:

bash
curl https://platform.passolution.de/feed/events/priority/high.xml

Events nach Land

GET /feed/events/countries/{code}.xml
Parameter Beschreibung
code ISO 3166-1 alpha-2 (z.B. de) oder alpha-3 (z.B. deu), case-insensitive

Beispiel:

bash
curl https://platform.passolution.de/feed/events/countries/de.xml

Events nach Event-Typ

GET /feed/events/types/{type}.xml
Parameter Beschreibung
type Event-Typ-Code (aus meta.json), case-insensitive

Beispiel:

bash
curl https://platform.passolution.de/feed/events/types/earthquake.xml

Events nach Region

GET /feed/events/regions/{region}.xml
Parameter Beschreibung
region Numerische Region-ID

Beispiel:

bash
curl https://platform.passolution.de/feed/events/regions/3.xml

RSS-Struktur (Events)

Jedes Event-Item im Feed enthält folgende Elemente:

Standard-RSS-Elemente

Element Beschreibung
<title> Titel des Events
<link> URL zur Event-Detailseite
<guid> Permanenter Link (identisch mit <link>)
<description> Kurzübersicht: Typ, Zeitraum, Priorität, Länder
<content:encoded> Vollständige Beschreibung
<pubDate> Erstellungsdatum (RFC 2822)
<category> Priorität und Event-Typen
<dc:creator> Ersteller (falls vorhanden)
<source> Quellenangabe mit URL
<enclosure> Länderbild (JPEG, falls vorhanden)

Benutzerdefinierte Elemente: article:data

xml
<article:data>
  <article:start_date>Mon, 11 Feb 2026 08:00:00 +0000</article:start_date>
  <article:end_date>Tue, 18 Feb 2026 08:00:00 +0000</article:end_date>
  <article:priority>high</article:priority>
  <article:event_type code="earthquake">Erdbeben</article:event_type>
</article:data>
Element Beschreibung
article:start_date Startdatum des Events
article:end_date Enddatum des Events
article:priority Prioritätsstufe: high, medium, low, info
article:event_type Event-Typ mit code-Attribut und Name als Inhalt (mehrere möglich)

Benutzerdefinierte Elemente: country:data

Pro betroffenem Land wird ein <country:data>-Block ausgegeben:

xml
<country:data>
  <country:name_de>Thailand</country:name_de>
  <country:name_en>Thailand</country:name_en>
  <country:iso_code>TH</country:iso_code>
  <country:iso3_code>THA</country:iso3_code>
  <country:is_eu_member>false</country:is_eu_member>
  <country:is_schengen_member>false</country:is_schengen_member>
  <country:continent>Asien</country:continent>
  <country:currency_code>THB</country:currency_code>
  <country:phone_prefix>+66</country:phone_prefix>
  <country:capital>
    <country:capital_name>Bangkok</country:capital_name>
    <geo:lat>13.7563</geo:lat>
    <geo:long>100.5018</geo:long>
  </country:capital>
</country:data>
Element Beschreibung
country:name_de Ländername (deutsch)
country:name_en Ländername (englisch)
country:iso_code ISO 3166-1 alpha-2 Code
country:iso3_code ISO 3166-1 alpha-3 Code
country:is_eu_member true / false
country:is_schengen_member true / false
country:continent Kontinent (deutsch)
country:currency_code ISO 4217 Währungscode
country:phone_prefix Internationale Telefonvorwahl
country:capital_name Name der Hauptstadt
geo:lat Breitengrad der Hauptstadt
geo:long Längengrad der Hauptstadt

XML-Namespaces

xml
<rss version="2.0"
  xmlns:atom="http://www.w3.org/2005/Atom"
  xmlns:dc="http://purl.org/dc/elements/1.1/"
  xmlns:content="http://purl.org/rss/1.0/modules/content/"
  xmlns:country="http://global-travel-monitor.eu/ns/country"
  xmlns:article="http://global-travel-monitor.eu/ns/article"
  xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#">

Länder-Feeds

Die Länder-Feeds liefern Verzeichnisse mit Länderdetails (Name, ISO-Codes, EU/Schengen-Status, Kontinent, Währung, Hauptstadt mit Koordinaten).

Alle Länder

GET /feed/countries/names/all.xml

Länder nach Kontinent

GET /feed/countries/continent/{code}.xml
Parameter Gültige Werte
code EU (Europa), AS (Asien), AF (Afrika), NA (Nordamerika), SA (Südamerika), OC (Ozeanien), AN (Antarktis)

Beispiel:

bash
curl https://platform.passolution.de/feed/countries/continent/EU.xml

EU-Mitgliedsstaaten

GET /feed/countries/eu.xml

Schengen-Staaten

GET /feed/countries/schengen.xml

Endpunkt-Übersicht

Endpunkt Format Beschreibung
/feed/events/meta.json JSON Verfügbare Priorities und Event-Typen
/feed/events/all.xml RSS 2.0 Alle aktiven Events
/feed/events/all.atom Atom 1.0 Alle aktiven Events
/feed/events/priority/{priority}.xml RSS 2.0 Events nach Priorität
/feed/events/countries/{code}.xml RSS 2.0 Events nach Land
/feed/events/types/{type}.xml RSS 2.0 Events nach Event-Typ
/feed/events/regions/{region}.xml RSS 2.0 Events nach Region
/feed/countries/names/all.xml RSS 2.0 Alle Länder
/feed/countries/continent/{code}.xml RSS 2.0 Länder nach Kontinent
/feed/countries/eu.xml RSS 2.0 EU-Mitgliedsstaaten
/feed/countries/schengen.xml RSS 2.0 Schengen-Staaten

Support

Bei Fragen zur Feed API wenden Sie sich an Ihren Ansprechpartner bei Passolution.