Apostamos por lo tecnológico n.º 1: Actualizaciones de TI en el Sistema Global del IPJ y API de descarga de la Copia de Oro de los archivos
En esta nueva serie de blogs, Christoph Schneider, Responsable de Desarrollo Tecnológico y Operaciones de la GLEIF, explica las últimas actualizaciones técnicas que se están llevando a cabo en la infraestructura de TI global de la GLEIF mientras el equipo de TI se esfuerza por hacer que los datos del IPJ estén más disponibles para sus usuarios. En esta primera entrega se ofrece una visión general de las últimas actualizaciones de la API de descarga de la Copia de Oro de los archivos y su importancia para lograr la escalabilidad.
Autor: Christoph Schneider
Fecha: 2022-09-30
Visualizaciones:
La clave de las operaciones de la GLEIF es el compromiso de ofrecer transparencia y accesibilidad a nuestros servicios de datos y de identificación de personas jurídicas. La clave para ello es una infraestructura de TI global y sólida que garantice que todos los consumidores de datos del Sistema Global del IPJ puedan integrar, acceder y utilizar fácilmente los datos del IPJ en varias plataformas y sistemas.
El departamento de TI de la GLEIF trabaja incansablemente para garantizar que su infraestructura global ofrezca la mejor experiencia de usuario posible, actualizándola y perfeccionándola constantemente a medida que el Sistema Global del IPJ crece. La última actualización en este proceso está relacionada con la API de descarga de la Copia de Oro de los archivos, que se actualizará a partir del 10 de octubre. La Copia de Oro de los archivos y los archivos delta de la GLEIF se actualizan tres veces al día y garantizan un acceso sencillo a la última información sobre IPJ nuevos y actualizados. La conexión de la API de descarga es fundamental para muchos equipos de desarrollo que dependen de las actualizaciones automáticas de datos para proporcionar datos precisos y oportunos a su organización. El último cambio en la API de descarga de la Copia de Oro de los archivos ayudará a los usuarios a conseguir más escalabilidad y fiabilidad, y a solucionar los problemas de rendimiento relacionados con las descargas de archivos servidas directamente por la API.
¿A quién afectará esta actualización?
Esta actualización permitirá el redireccionamiento a la ruta directa del archivo en lugar de hacerlo a una descarga directa desde el punto final de la API. Los equipos que utilicen URL de API de descarga de la Copia de Oro de los archivos que den lugar a una descarga directa de archivos (por ejemplo, https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) tendrán que actualizar las configuraciones de acuerdo con este cambio. Si está utilizando la API de esta forma, indíquelo a su equipo técnico para asegurarse de que el redireccionamiento funcione como se espera.
Tenga en cuenta que este cambio afecta a los dominios siguientes:
La API de descarga de la Copia de Oro de los archivos ofrece varios puntos finales de la API muy prácticos para descargar la Copia de Oro de los archivos (delta) directamente según un patrón de fecha de publicación o la palabra clave especial «latest». Para obtener más información, consulte las Especificaciones y manual del usuario de la Copia de Oro de los Archivos y los Archivos Delta de la GLEIF, cuyo enlace se encuentra al final de este artículo.
Actualmente, la llamada a un punto final de la API de descarga dará lugar a la descarga directa del archivo (código de respuesta HTTP 200). A continuación se muestra un ejemplo basado en curl:
Curl https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv
# HTTP/1.1 200 OK
Y después de la fecha sugerida (2022-10-10), todas las solicitudes de la API se redirigirán a la ruta de descarga directa de archivos (código de respuesta HTTP 302 con una cabecera de Location). A continuación se muestra un ejemplo basado en curl:
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
En el ejemplo anterior basado en curl, el único cambio necesario es la adición del indicador de Location (-L o --location) para garantizar que se siga la nueva ubicación redireccionada. Este comportamiento puede ser predeterminado o puede que sea necesario configurarlo y manejarlo de manera diferente según el cliente HTTP utilizado. Todos los consumidores de datos deben asegurarse de que sus respectivos clientes/aplicaciones HTTP sigan y manejen adecuadamente los redireccionamientos, como se muestra arriba.
¿Cómo pueden configurar la actualización los equipos pertinentes?
Prepare y pruebe su sistema antes de implementar el cambio. Se introducirá el código de estado de redireccionamiento HTTP 302 y los sistemas existentes deben actualizarse para ser compatibles con el nuevo comportamiento a través de cualquiera de los siguientes métodos:
(Recomendado) Asegúrese de que su cliente/aplicación HTTP sigue y maneja los redireccionamientos correctamente. Este comportamiento puede ser predeterminado o puede que sea necesario configurarlo y manejarlo de manera diferente según el cliente HTTP utilizado.
Actualice manualmente su sistema para interpretar las respuestas HTTP 302 e inspeccionar la cabecera Location para comprobar si sigue la URL de descarga directa de archivos.
¿Hay un entorno de prueba temporal disponible?
La GLEIF ha proporcionado un entorno de prueba temporal para que los consumidores de datos comprueben si sus sistemas van a funcionar con el nuevo comportamiento y para que se aseguren de que se siguen los redireccionamientos a la descarga directa de archivos. Esto facilitará la transición al nuevo comportamiento de redireccionamiento.
A continuación encontrará ejemplos de entornos de prueba temporales que muestran el nuevo comportamiento de redireccionamiento:
Tenga en cuenta que este entorno de prueba solo admite la fecha de publicación 19990101-0000, pero el cambio se aplicará a todos los patrones, incluida la palabra clave especial «latest» (por ejemplo, …/publishes/lei2/latest.csv). Además, el entorno de prueba es una instantánea de ejemplo de un subconjunto de datos de la Copia de Oro solo a efectos de demostración. No está pensado para un uso real y el entorno se retirará una vez que se haya desplegado el nuevo comportamiento de la API de la Copia de Oro.
La GLEIF fomenta el compromiso con los consumidores de datos en todo el Sistema Global del IPJ. Si tiene alguna pregunta sobre la última actualización o le gustaría comentar cómo puede la GLEIF puede ayudar a su equipo a aprovechar el poder del IPJ, póngase en contacto con info@gleif.org.
Para estar al día de as las últimas novedades técnicas del equipo de TI de la GLEIF, haga clic aquí para suscribirse al boletín de notificaciones técnicas.
Palabras clave:
API: API son las siglas de Application Programming Interface (interfaz de programación de aplicaciones). Una API es un conjunto de definiciones y protocolos que permiten a los programas informáticos comunicarse entre sí a través de la red informática mundial.
Punto final: un punto final es una ubicación que recibe solicitudes web. Una API es un conjunto de puntos finales.
Solicitud de API: una llamada de API, o una solicitud de API, es un mensaje que se envía a un punto final (el servidor) en el que se solicita una API para ofrecer un servicio o información.
Respuesta de API: los datos de respuesta recibidos de una API para ofrecer un servicio o información.
Códigos de estado de respuesta HTTP: es una lista de códigos de estado de respuesta del protocolo de transferencia de hipertexto (HTTP). Los códigos de estado los emite un servidor en respuesta a una solicitud de API realizada a un punto final, el servidor. Cada código de estado tiene un significado concreto.
Copia de Oro de los archivos: archivos que incluyen IPJ y datos de referencia relacionados que los emisores de IPJ cargan en la GLEIF.
Archivos delta: los archivos delta identifican solo los IPJ de nueva emisión y/o revisiones de datos de referencia de un IPJ facilitados en el pasado en la Copia de Oro del Archivo publicada con anterioridad: (ocho horas antes, 24 horas antes, siete días antes y el mayor de ellos, 31 días antes).
Servicios de la GLEIF: un conjunto de servicios prestados tanto al público como a nuestros socios para garantizar la integridad operativa en todo el Sistema Global del IPJ.
Si quiere hacer comentarios sobre algún artículo del blog, identifíquese con su nombre y sus apellidos. Su nombre aparecerá junto a su comentario. No se publicarán las direcciones de correo electrónico. Tenga en cuenta que, mediante su acceso al foro de debate o su contribución en él, acuerda cumplir los términos de las Directrices sobre los blogs de la GLEIF, por lo que le pedimos que los lea detenidamente.
Christoph Schneider es Responsable de Desarrollo Tecnológico y Operaciones de la Global Legal Entity Identifier Foundation (GLEIF). En junio de 2017, Christoph se unió a la Organización Internacional de Normalización (ISO) como colíder del grupo de trabajo del Grupo asesor técnico de FinTech del Comité técnico 68 (ISO TC 68 FinTech TAG) que se ocupa de la identidad digital. Tiene una amplia experiencia en el desarrollo e implementación de soluciones en tecnología financiera. Christoph tiene un máster en Sistemas de Información Empresarial por la Technische Universität Darmstadt.
