Getting Technical #1 : Mises à jour informatiques dans le Global LEI System et API de téléchargement du fichier de la copie validée
Dans cette nouvelle série de blogs, Christoph Schneider, Directeur du développement et des opérations informatiques de la GLEIF, décrit les dernières mises à jour techniques affectant l'infrastructure informatique mondiale de la GLEIF tandis que l'équipe informatique met tout en œuvre pour améliorer l'accès aux données LEI pour ses utilisateurs. Ce premier numéro présente sommairement les dernières mises à jour de l'API de téléchargement du fichier de la copie validée et sa contribution majeure pour l'évolutivité.
Auteur: Christoph Schneider
Date: 2022-09-30
Vues:
La mission centrale de la GLEIF consiste à garantir la transparence et l'accessibilité aux services d'identification et de données des entités juridiques. Cet objectif ne peut être atteint sans une solide infrastructure informatique mondiale qui permet à tous les utilisateurs des données du Global LEI System d’intégrer, de consulter et d’utiliser les données LEI sur plusieurs plates-formes et systèmes.
Le service informatique de la GLEIF travaille sans relâche afin que l'infrastructure mondiale procure la meilleure expérience utilisateur possible, par des mises à jour et des perfectionnements constants à mesure que le Global LEI System se développe. La dernière mise à jour concerne l'API de téléchargement du fichier de la copie validée qui sera actualisée à partir du 10 octobre. La GLEIF actualise trois fois par jour les Copies validées et les fichiers delta afin de pouvoir bénéficier des informations les plus récentes sur les nouveaux LEI et ceux mis à jour. L'API de téléchargement est cruciale pour bon nombre d'équipes de développement qui dépendent des mises à jour automatiques des données pour fournir, à temps et avec la plus grande précision, des données à leur organisation. Grâce à la dernière modification apportée à l'API de téléchargement des fichiers de copies validées, les utilisateurs pourront notamment bénéficier de plus d'évolutivité et de fiabilité tout en surmontant les engorgements des téléchargements opérés directement par l'API.
Qui sera concerné par cette mise à jour ?
Cette mise à jour entraînera un transfert (renvoi) vers le chemin d'accès direct au fichier au lieu d'un téléchargement direct à partir du point de terminaison de l'API. Les équipes qui utilisent les URL de l'API de téléchargement de fichiers de copies validées débouchant sur un téléchargement direct (p. ex. https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) devront modifier leurs configurations en conséquence. Si vous utilisez l'API de cette manière, veuillez signaler cette mise à jour à votre équipe technique afin de assurer que le transfert fonctionne comme prévu.
Tenez compte des domaines ci-dessous qui seront affectés par ce changement :
L'API de téléchargement du fichier de la copie validée comprend plusieurs points de terminaison pratiques permettant de télécharger directement les fichiers (delta) des copies validées selon un modèle de date de publication ou le mot-clé spécial « latest ». Pour en savoir plus, veuillez consulter les Spécifications et manuel d'utilisation des Copies validées et des Fichiers delta de la GLEIF. Vous trouverez un lien à la fin de cet article.
Actuellement, l'appel d'un point de terminaison de l'API de téléchargement entraîne le téléchargement direct du fichier (code de réponse HTTP 200). Un exemple fondé sur curl est illustré ci-dessous :
Curl https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv
# HTTP/1.1 200 OK
Après la date proposée (2022-10-10), toutes les demandes API seront transférées vers le chemin de téléchargement direct (code de réponse 302 HTTP avec une en-tête « Location »). Un exemple fondé sur curl est illustré ci-dessous :
curl -L https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv
#HTTP/1.1 302 Found
# Location: https://goldencopy.gleif.org/storage/golden-copy-files/2022/06/01/6/20220601-0000-gleif-goldencopy-lei2-golden-copy.csv.zip
# ...
# HTTP/1.1 200 OK
Dans l'exemple curl ci-dessus, la seule modification nécessaire consiste à ajouter l'indicateur d'emplacement (-L ou --location) pour s'assurer que le nouvel emplacement redirigé est suivi. Cette action peut être par défaut ou doit être configurée ou traitée d'une certaine manière en fonction du client HTTP utilisé. Tous les utilisateurs de données doivent s'assurer que leurs clients/applications HTTP respectifs suivent et traitent correctement les redirections, comme indiqué ci-dessus.
Comment les équipes concernées peuvent-elles configurer la mise à jour ?
Préparez et testez votre système avant la mise en œuvre du changement. Le code d'état de renvoi HTTP 302 sera intégré et les systèmes existants doivent être mis à jour pour accompagner le nouveau comportement de manière compatible par l'une des méthodes suivantes :
(Recommandé) Veillez à ce que votre client/application HTTP suive et traite correctement les redirections. Cette action peut être par défaut ou doit être configurée ou traitée d'une certaine manière en fonction du client HTTP utilisé.
Mettez à jour manuellement votre système afin de comprendre les réponses HTTP 302 et contrôlez l'en-tête « Location » pour suivre l'adresse URL de téléchargement direct.
Y a-t-il un environnement de test temporaire ?
La GLEIF a mis en place un environnement de test temporaire afin que les utilisateurs de données puissent vérifier le bon fonctionnement de leurs systèmes à la suite de ce changement et s'assurer que les redirections vers le téléchargement direct de fichiers sont effectivement suivies. La transition vers cette nouvelle redirection sera d'autant plus fluide.
Vous trouverez ci-dessous des exemples du nouveau comportement de redirection provenant de l'environnement de test temporaire :
Cet environnement de test ne prend en charge que la date de publication 19990101-0000, mais le changement s'appliquera à tous les modèles, y compris le mot-clé spécial « latest » (p. ex. …/publishes/lei2/latest.csv). De plus, l'environnement de test représente un instantané d'un sous-ensemble de données de la copie validée à des fins d'illustration uniquement. Cet environnement n'est pas destiné à être utilisé et sera mis hors service après la mise en œuvre de la mise à jour de l'API de copie validée.
La GLEIF encourage les interactions avec les utilisateurs de données dans l'ensemble du Global LEI System. Pour toute question concernant la dernière mise à jour ou pour savoir comment la GLEIF peut aider votre équipe à tirer le meilleur parti des LEI, veuillez contacter info@gleif.org.
Pour être informé à tout moment des nouveautés et développements techniques de l'équipe informatique de la GLEIF, cliquez ici pour s'abonner à la newsletter des notifications techniques.
Principaux termes :
API - API signifie Application Programming Interface et désigne une interface de programmation d'application. Une API est un ensemble de définitions et de protocoles qui permettent aux programmes informatiques de communiquer entre eux sur Internet.
Point de terminaison - Un point de terminaison est un lieu qui réceptionne les demandes Internet. Une API est un ensemble de points de terminaison.
Demande API - Un appel API, ou demande API, est un message envoyé à un point de terminaison (le serveur) pour demander à une API de fournir un service ou des informations.
Réponse API - Les données de réponse provenant d'une API afin de fournir un service ou des informations.
Codes d'état de réponse HTTP - Voici une liste de codes d'état de réponse HTTP (Hypertext Transfer Protocol). Un serveur émet les codes d'état en réponse à une demande API adressée à un point de terminaison, le serveur. Chaque code d'état possède sa propre signification.
Fichiers de copies validées - Fichiers, y compris les LEI et les données de références associées, chargés par les émetteurs de LEI pour la GLEIF.
Fichiers delta - Les fichiers delta indiquent uniquement les LEI nouvellement émis et/ou les révisions de données de référence associées à un LEI déclaré précédemment dans une Copie validée publiée plus tôt (8 heures auparavant, 24 heures auparavant, sept jours auparavant et, pour les plus importants, 31 jours auparavant).
Services de la GLEIF - Ensemble de services mis à la disposition du public et de nos partenaires pour garantir l'intégrité opérationnelle dans le Global LEI System.
Si vous souhaitez commenter une publication sur le blog, veuillez vous identifier à l'aide de votre prénom et de votre nom. Votre nom apparaîtra à côté de votre commentaire. Aucune adresse e-mail ne sera publiée. Veuillez noter qu'en accédant ou en contribuant au forum de discussion, vous acceptez de respecter les conditions de la Politique de la GLEIF en matière de blog ; veuillez donc les lire attentivement.
Christoph Schneider occupe le poste de Directeur du développement et des opérations informatiques de la Global Legal Entity Identifier Foundation (GLEIF). En juin 2017, Christoph a rejoint l’Organisation internationale de normalisation au poste de co-directeur du Group de conseil technique sur les technologies financières du Comité technique de normalisation 68 (ISO TC 68 FinTech TAG), chargé de l’identité numérique. Il possède une vaste expérience dans le développement et la mise en place de solutions pour les technologies financières. Christoph est titulaire d'un master en Systèmes d'information en entreprise de l'Université technique de Darmstadt.
