Qu’est le RSS ? Pourquoi est-il utilisé ?
RSS (Rich Site Summary) est un type de contenu web qui permet aux utilisateurs d’accéder aux mises à jour de contenu en ligne dans un format standardisé et lisible.
Dans le contexte de l’API, RSS fournit aux utilisateurs un moyen très simple d’être informés automatiquement des derniers changements sur les produits de données et listes de code publiés par Eurostat.
Comment accéder au contenu RSS ?
L’URL à utiliser pour accéder au flux RSS dépend de :
l’agence (exemple : Eurostat).
la langue. Il y a un contenu RSS pour chaque langue supportée :
Anglais
Allemagne
Français
Voici les Urls pour les flux RSS :
Version anglaise : https://ec.europa.eu/eurostat/api/dissemination/catalogue/rss/en/statistics-update.rss
Version allemande : https://ec.europa.eu/eurostat/api/dissemination/catalogue/rss/de/statistics-update.rss
Version française : https://ec.europa.eu/eurostat/api/dissemination/catalogue/rss/fr/statistics-update.rss
Comment et quand sont générés les fichiers RSS ?
Les fichiers RSS sont construit automatiquement, à chaque publication des données. Ils listent tous les changements qui ont été disséminés.
Les informations suivantes sont incluses :
Les opérations faites sur les ensembles de donnée pendant les 7 derniers jours (les évènements de la catégorie donnée, voir ci-dessous):
Création d’un ensemble de données
Mise à jour d’un ensemble de donnée
Suppression d’un ensemble de donnée
Les opérations faites sur les structures de donnée pendant les 7 derniers jours (les évènements de la catégorie structure de donnée, voir ci-dessous)
Les opérations faites sur les listes de code pendant les 7 derniers jours (les évènements de la catégorie liste de codes, voir ci-dessous) :
Création d’un nouveau code ou nouvelle position dans une liste de codes
Suppression d’un code ou d’une position dans une liste de codes
Quelle est la structure et le contenu d’un fichier de flux RSS ?
Chaque fichier RSS est construit avec la structure suivante :
L’entête : La première partie contient l’information Générale sur le fichier RSS
Les articles : La deuxième partie contient toutes les informations concernant les dernières mises à jour
Champs disponibles dans la partie entête
xml : version XML : version 1.0, encodage en UTF-8
version : Version du fichier RSS (2.0)
channel : Fichier qui contient un seul canal. Dans celui-ci les informations suivantes seront présentes :
title : Le titre du fichier RSS (Eurostat - Mises à jour des données et structures de donnée)
link : URL vers le fichier RSS
description : Description du flux RSS
language : Code de la langue du fichier RSS. Les codes existants sont :
en : Anglais
de : Allemand
fr : Français
copyright : Information de copyright
pubDate : Date la dernière mise à jour du fichier RSS (dans le format suivant: yyyy-MM-dd HH:mm:ss, exemple: 2018-09-25 12:45:18)
image
link : voir link ci-dessus
title : voir title ci-dessus
Champs disponibles dans la partie articles
Dans le fichier RSS, les articles sont triés dans un ordre spécifique :
Date du changement en ordre décroissant
Type de produit
Liste de code
Supprimé
Nouveau
Mis à jour
Ensemble de données (changement de donnée ou structure)
Supprimé
Nouveau
Mis à jour
Chaque sous-catégorie au point 2 est ensuite triée par ordre alphabétique.
Chaque article indique une modification de l’information contenue dans notre base de données. Chaque article contient les champs suivants :
title : Titre de l’article composé de l’identifiant et su type :
Identifier : L’ID de l’article en majuscules
Type : Le type d’évènement
description : Le titre de l’article (dans la langue choisie)
category : Le titre de l’article (dans la langue choisie) :
DELETED_CODE_LIST
NEW_CODE_LIST
UPDATED_CODE_LIST
DELETED_DATASET
NEW_DATASET
UPDATED_DATASET_STRUCTURE : dans le cas où uniquement l’annotation UPDATE_STRUCTURE a changée
UPDATED_DATASET_DATA : dans le cas où uniquement l’annotation UPDATE_DATA a changée
UPDATED_DATASET_STRUCTURE_DATA : dans le cas où les annotations UPDATE_STRUCTURE et UPDATE_DATA ont été changées
pubDate : La date et heure de la release (dans le format suivant: yyyy-MM-dd HH:mm:ss, exemple: 2018-09-25 12:45:18.17)
link : L’URL qui fournit un accès direct pour télécharger cet article en utilisant l’API :
Pour un ensemble de données : URL de la page produit de l’ensemble de données dans Data Browser
Pour une liste de code : Le lien de téléchargement de l’API en format TSV de la liste de code dans la langue du flux RSS
Le cas d’un renommage d’un code d’une liste de codes, d’une dimension ou d’un ensemble de données sera rapporté par le flux RSS comme deux événements séparés :
Suppression de l’ancien nom
Insertion du nouveau nom
Quels outils peuvent être utilisés pour manipuler le flux RSS ?
Les utilisateurs doivent s’inscrire au flux en utilisant un lecteur de flux RSS, ou un agrégateur, dans leur navigateur internet. Cet outil vérifiera les mises à jour et notifiera les utilisateurs quand des mises à jour ont été disséminées.
Il existe une variété de lecteurs disponibles et des nouvelles versions apparaissent constamment. La façon de s’inscrire est différente pour chaque lecteur. Celui choisi par l’utilisateur lui décrira la marche à suivre.
Dès que l’utilisateur aura téléchargé et installé le lecteur choisi, il devra suivre les instructions fournies par le lecteur de flux pour ajouter l’URL du flux désiré fourni dans la première section de la page.