Lancement de la version 3 de l’API de la banque de données de l’IITA en janvier 2022

  • 6 décembre 2021

Le Secrétariat de l’IITA a le plaisir d’annoncer le lancement de la version 3 de l’API de la banque de données de l’Initiative, qui aura lieu le 11 janvier 2022. La banque de données offre un accès efficace aux données relatives à l’action humanitaire et au développement communiquées selon la norme de l’IITA.

Cette nouvelle version de l’API répond à un cahier des charges plus strict et permet de réduire les coûts et de gagner en efficacité par rapport aux versions précédentes. Elle sera lancée sur la nouvelle plateforme unifiée de l’IITA, signe d’une grande avancée dans la centralisation des différents outils techniques isolés de l’IITA en un système homogène et intégré.

La version 3 de l’API de la banque de données

Ces six derniers mois, l’équipe technique de l’IITA a rapatrié la banque de données de l’IITA en interne et reconfiguré son architecture. Le mois dernier, l’équipe s’est employée à tester l’API avec l’aide d’un groupe d’utilisateurs dédié, et celle-ci pourra être lancée après les fêtes de fin d’année.

Une fois lancée, la version 3 de l’API offrira aux utilisateurs un accès plus rapide et plus fiable aux données de l’IITA grâce aux fonctionnalités suivantes :

  • 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

  • Accès via le portail API de l’IITA
    • Utilisation nécessitant une clé API gratuite (pour permettre à l’équipe technique de l’IITA de mieux suivre l’utilisation des données et assurer un service fiable et sécurisé aux utilisateurs).

Redirection des appels API – migration vers le portail API

Depuis juillet 2021, les appels API (uniquement au format XML) effectués sur la page https://iatidatastore.iatistandard.org sont redirigés vers le Datastore Classic de la communauté de l’IITA. Au 11 janvier 2022, ces appels seront 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 passer auportail API de l’IITA et les données XML leur seront renvoyées au format XML utilisé par l’IITA.

À compter du 11 janvier 2022, les 98 % de redirections pour lesquelles les résultats doivent être au format JSON ou CSV seront traitées par la version 3 de l’API de la banque de données de l’IITA. Au bout de six mois, les utilisateurs devront passer au portail API de l’IITA pour accéder à l’API. Il n’y aura aucune différence en ce qui concerne le format des données reçues.

À venir : dynamisation des outils de l’IITA

Le lancement de la nouvelle version de la 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 banque de données. Les données présentées dans la prochaine version de la plateforme d-portal correspondront par ailleurs à celles de la banque de données.

Assistance supplémentaire

Pour le lancement du 11 janvier, nous publierons un guide sur le contrat d’API et l’utilisation de l’API de la banque de données de l’IITA, ainsi qu’un lien vers la documentation officielle de la plateforme SOLR. Si vous avez besoin d’aide pour passer à la nouvelle API ou pour l’utiliser, veuillez contacter 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.