Child pages
  • API Catalogue - Wie verwende ich die RSS-Feeds

Was ist der RSS? Warum wird es verwendet?

RSS (Rich Site Summary) ist eine Art Web-Feed, mit dem Benutzer auf Aktualisierungen von Online-Inhalten in einem standardisierten, computerlesbaren Format zugreifen können.

Im Rahmen der API bietet RSS den Benutzern eine sehr einfache Möglichkeit, automatisch über die letzten von Eurostat veröffentlichten Änderungen an Datenprodukten und Codelisten informiert zu werden.

Wie greife ich auf die RSS-Feeds zu?

Die URL, über die Sie auf den RSS-Feed zugreifen können, hängt ab von:

  • der Agentur (Beispiel: Eurostat).

  • der Sprache. Für jede unterstützte Sprache gibt es einen RSS-Feed:

    • Englisch

    • Deutsch

    • Französisch

Hier sind die URLs der RSS-Feeds:

Wie und wann werden die RSS-Dateien erstellt?

Die RSS-Dateien werden bei jeder Datenfreigabe automatisch erstellt. Sie listen alle Änderungen auf, die verbreitet wurden.

Sie enthalten Informationen über:

  • Die Datensatz-Vorgänge, die innerhalb der letzten 7 Tage verarbeitet wurden (dies sind Ereignisse, deren Kategorie Daten sind, siehe unten):

    • Erstellung eines Datensatzes

    • Aktualisierung eines Datensatzes

    • Löschen eines Datensatzes

  • Die Datenstrukturoperationen, die innerhalb der letzten 7 Tage verarbeitet wurden (dies sind Ereignisse, deren Kategorie die Datenstruktur ist, siehe unten)

  • Der Code listet Vorgänge auf, die innerhalb der letzten 7 Tage verarbeitet wurden (dies sind Ereignisse, deren Kategorie die Codeliste ist, siehe unten):

    • Erstellung eines neuen Codes / einer neuen Position in einer Codeliste

    • Entfernen eines Codes / einer Position aus einer Codeliste

Wie sind Struktur und Inhalt einer RSS-Feed-Datei aufgebaut?

Jede RSS-Datei wird mit der folgenden Struktur erstellt:

  • Der Header: Dieser erste Teil enthält die allgemeinen Informationen zur RSS-Datei selbst

  • Die Elemente: Dieser zweite Teil enthält alle Informationen zu den letzten Aktualisierungen

Im Header-Teil verfügbare Felder

  • xml: XML-Version: Version 1.0, Codierung ist UTF-8

  • version: Version der RSS-Datei (2.0)

  • channel: Die Datei enthält nur einen Kanal. Darin sind folgende Informationen enthalten:

    • title: Titel der RSS-Datei (Eurostat - Daten- und Datenstrukturaktualisierungen)

    • link: URL zur RSS-Datei

    • description: Beschreibung des RSS-Feeds

    • language: Code der Sprache der RSS-Datei. Bestehende Codes sind:

      • en: Englisch

      • de: Deutsch

      • fr: Französisch

    • copyright: Copyright-Informationen

    • pubDate: Zeitstempel der letzten Aktualisierung der RSS-Datei (im folgenden Format: JJJJ-MM-TT HH: MM: SS, Beispiel: 2018-09-25 12:45:18)

    • image

      • link: Siehe link oben

      • title: Siehe title oben

In einem Artikelteil verfügbare Felder

Innerhalb der RSS-Datei werden die Elemente in dieser bestimmten Reihenfolge sortiert:

  • Änderungsdatum absteigend

  • Produkttyp

    • Codelisten

      • Gelöscht

      • Neu

      • Aktualisiert

    • Datensätze (Daten- oder Strukturänderung)

      • Gelöscht

      • Neu

      • Aktualisiert

  • Jede Unterkategorie an Punkt 2 wird dann alphabetisch sortiert.

Jeder Artikel zeigt eine Aktualisierung der in unserer Datenbank enthaltenen Informationen an. In jedem Element werden die folgenden Felder erwähnt:

  • title: Titel des Elements, bestehend aus Kennung und Typ:

    • Identifier: Die ID des Elements in UPPER CASE

    • Type: Der Typ des Ereignisses

  • description: Der Titel des Elements (in der ausgewählten Sprache)

  • category: Die Art des Ereignisses entsprechend der Art und Art der Änderung:

    • DELETED_CODE_LIST

    • NEW_CODE_LIST

    • UPDATED_CODE_LIST

    • DELETED_DATASET

    • NEW_DATASET

    • UPDATED_DATASET_STRUCTURE: Für den Fall, dass sich nur die Annotation UPDATE_STRUCTURE geändert hat

    • UPDATED_DATASET_DATA: falls sich nur die Annotation UPDATE_DATA geändert hat

    • UPDATED_DATASET_STRUCTURE_DATA: falls sich die Anmerkungen UPDATE_STRUCTURE und UPDATE_DATA geändert haben

  • pubDate: Datum und Uhrzeit der Veröffentlichung (im folgenden Format: JJJJ-MM-TT HH: MM: SS, Beispiel: 2018-09-25 12: 45: 18.17)

  • link: Die URL, die den direkten Zugriff zum Herunterladen dieses Elements über die API ermöglicht:

    • Für ein Dataset: URL der Data Browser-Produktseite des zugehörigen Datasets

    • Für eine Codeliste: API TSV-Download-Link der zugehörigen Codeliste in der Sprache, die in der URL des RSS-Feeds festgelegt ist

Der Fall der Umbenennung eines Codelistencodes, einer Dimension oder eines Datensatzes wird im RSS-Feed als zwei separate Ereignisse gemeldet:

  1. Löschen des alten Namens

  2. Einfügen des neuen Namens

Mit welchen Tools können die RSS-Dateien betrieben werden?

Benutzer müssen einen Feed zusätzlich zu ihrem Webbrowser mit einem RSS-Feed-Reader oder Aggregator abonnieren. Dadurch wird nach Updates gesucht und die Benutzer benachrichtigt, wenn Updates verbreitet wurden.

Es gibt eine Reihe verschiedener Newsreader und es erscheinen ständig neue Versionen. Die Abonnementmechanismen sind für jeden Feed-Reader unterschiedlich, aber die vom Benutzer ausgewählte Methode enthält entsprechende Anweisungen.

Nachdem Benutzer einen Reader heruntergeladen und installiert haben, sollten Sie die Anweisungen des Readers befolgen, um die gewünschten RSS-URLs hinzuzufügen, die im ersten Abschnitt dieser Seite angegeben sind.

_