L’IITA a aujourd’hui le plaisir d’annoncer le lancement de la nouvelle API de sa banque de donnés sur sa plateforme unifiée. Celle-ci permettra aux membres d’intégrer cette banque de données en interne, comme l’Initiative s’y était engagée. 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.
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.
Parmi diverses améliorations, la version 3 de l’API propose trois grandes fonctionnalités demandées par la communauté de l’IITA :
Notez bien que la banque de données de l’IITA contient uniquement des données conformes au schéma de l’IITA pour les données XML. Par conséquent, si une organisation publie des données contenant des erreurs critiques (identifiées par l’outil de validation de l’IITA), celles-ci ne seront pas accessibles par l’intermédiaire de la banque de données de l’IITA. Tous les utilisateurs peuvent se servir de l’outil de validation de l’IITA pour vérifier :
L’IITA a réalisé une série de documents et de guides d’utilisation afin de vous aider à prendre en main la version 3 de l’API de sa banque de données :
Marche à suivre pour créer un compte sur le portail API. Vous devez créer un compte avant de pouvoir commencer à utiliser l’API.
2. Comment utiliser la nouvelle API de la banque de données de l’IITA
Guide détaillé sur la création de requêtes à l’aide de l’API. Ce guide contient un lien vers l’ensemble de la documentation de la plateforme SOLR.
3. Contrat d’API pour la version 3
Description des fonctionnalités de l’API que l’IITA s’engage à conserver. L’IITA ne procédera pas à des modifications critiques sur la version 3 de l’API. En d’autres termes, le format des requêtes et des données reçues ne changera pas dans le cadre de la version 3.
4. Comment passer d’iati.cloud à la version 3 de l’API de la banque de données de l’IITA
Présentation des différences entre la version précédente de la banque de données de l’IITA (désormais iati.cloud) et la nouvelle version 3 de l’API. Cet article explique comment modifier vos requêtes de façon à extraire les mêmes données.
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. Comme nous l’avons déjà annoncé, à partir d’aujourd’hui, les appels API effectués sur la page https://iatidatastore.iatistandard.org seront redirigés vers 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.
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.
Au bout de six mois, les utilisateurs devront passer au portail API 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.
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.