Banque de données de l’IITA

À propos de la banque de données de l’IITA

La version 3 de l’API de la banque de données de l’IITA permet d’accéder aux données relatives aux ressources et aux résultats publiées par les organisations conformément à la norme de l’IITA.

• Actualisation dynamique des données dès leur mise à disposition via le registre de l’IITA. Nous avons pour objectif de traiter toutes les données dans les 24 heures suivant leur mise à disposition.
• Disponibilité de toutes les données valides (c’est-à-dire conformes au schéma de l’IITA pour les données XML) aux formats JSON, CSV et XML.
• Possibilité pour les utilisateurs de rechercher des données IITA à partir de tous les éléments et attributs figurant dans la norme.
• Possibilité de rechercher des données IITA et de les exporter dans l’un des trois formats CSV suivants :
  • Une activité par ligne
  • Une transaction par ligne
  • Un budget par ligne

La version 3 de l’API est disponible sur la plateforme unifiée de l’IITA :

• Accéder à l’API
• Comment créer un compte pour obtenir une clé API

Qui peut utiliser la version 3 de l’API de la banque de données de l’IITA ?

Pour utiliser la banque de données de l’IITA, les utilisateurs devront tout d’abord disposer des compétences techniques nécessaires et comprendre la structure et les éléments fondamentaux de la norme de l’IITA. Cela permet de savoir quels types de données relatives à l’action humanitaire et au développement peuvent être recherchés et consultés. Ces informations sont disponibles dans les supports suivants :

• Comment utiliser l’API de la banque de données
• Contrat d’API pour la version 3
• Documents de référence de l’IITA

Quelles sont les données accessibles ?

La banque de données de l’IITA permet d’accéder aux données publiées par les organisations ayant utilisé la version 2 de la norme de l’IITA. Cela fait suite à la décision des membres de l’IITA de déclasser la version 1 de la norme, entrée en vigueur en juillet 2019.

Afin de garantir la qualité des données accessibles aux utilisateurs, la banque de données ne détient aucune information non conforme au schéma de l’IITA. Ce dernier fournit l’ordre et le format exacts que les signataires doivent respecter lorsqu’ils soumettent leurs fichiers XML. De plus amples informations sur le schéma de l’IITA sont disponibles sur la page dédiée du site de l’IITA.

Les fichiers considérés par l’outil de validation de l’IITA comme invalides, car présentant des erreurs critiques ne figurent pas dans la banque de données de l’IITA.

Sous quels formats puis-je accéder aux données ?

La banque de données de l’IITA vous permet de convertir les fichiers de données de l’IITA, publiés à l’origine au format XML, à deux autres formats : CSV et JSON. Toutes les données de la banque de données sont filtrées et extraites à partir des activités de l’IITA. À noter une exception lors de la conversion des données au format CSV : vous pouvez également extraire les données par budget et par transaction.

En résumé, vous pouvez extraire les données :

• au format XML – la banque de données renvoie les activités au format XML original. Toutes les informations publiées initialement sont affichées, ainsi que les métadonnées comprises dans le résultat au format XML.
• au format CSV – la banque de données convertit les données publiées initialement au format XML au format CSV. Ce format peut être utilisé pour analyser des informations à l’aide de logiciels de tableur, comme Microsoft Excel, LibreOffice Calc. ou Google Sheets. Vous pouvez, dans un fichier CSV, déterminer si chaque ligne doit correspondre à une activité, à un budget ou à une transaction spécifique.
• au format JSON – la banque de données convertit les données publiées initialement au format XML au format JSON. Toutes les informations publiées initialement sont affichées, ainsi que les métadonnées comprises dans le résultat au format XML.

Redirection des appels API – migration vers le portail API

Depuis juillet 2021, les appels API effectués sur la page https://iatidatastore.iatistandard.org étaient redirigés vers le Datastore Classic de la communauté de l’IITA.

Depuis le 11 janvier 2022, les appels API sur la page https://iatidatastore.iatistandard.org sont redirigés vers la version 3 de l’API de la banque de données de l’IITA. Ces redirections seront valables six mois. Pendant ce laps de temps, les utilisateurs de l’API recevront une réponse XML au même format que les réponses renvoyées par le Datastore Classic, de façon à ce que ce changement ne perturbe pas leur travail.

À l’issue de ces six mois, les utilisateurs devront se mettre à utiliser le portail API de l’IITA et les données XML leur seront renvoyées au format XML utilisé par l’IITA.

À venir : dynamisation des outils de l’IITA

Le lancement de la nouvelle banque de données marque un tournant décisif dans l’amélioration de l’accès aux données de l’IITA. En 2022, la nouvelle API sera employée pour créer de nouveaux outils de données afin de répondre aux besoins d’un large éventail d’utilisateurs.

L’équipe technique de l’IITA prévoit ainsi de développer une application Web pour la version 3 de la banque de données. Les données présentées dans la prochaine version de d-portal seront par ailleurs conformes à celles de la banque de données, et plusieurs fonctionnalités de traitement des données seront proposées entre les deux applications, notamment :

• la conversion des devises
• la ventilation par secteur, par pays ou par région
• un générateur de fichiers CSV, qui permettra aux utilisateurs de générer et formater leurs propres fichiers
• la possibilité d’extraire toutes les activités sans aucune mise en forme.

Maintenance de la banque de données et contacts

La banque de données de l’IITA a été conçue par l’équipe technique de l’IITA. Vous pouvez signaler des bogues ou suggérer des améliorations dans le dispositif de suivi des problèmes de Github.

Si vous avez besoin d’une aide supplémentaire pour passer à la nouvelle API ou pour l’utiliser, contactez le service d’assistance de l’IITA à l’adresse [email protected]. L’équipe technique de l’IITA se fera un plaisir de vous appeler pour vous aider à prendre en main cet outil.