Informações Técnicas nº 1: Atualizações de TI no Global LEI System & no API de download do arquivo Golden Copy
Nesta nova série do blog, Christoph Schneider, Diretor de Desenvolvimento e Operações de TI da GLEIF, explica as mais recentes atualizações técnicas que estão ocorrendo na infraestrutura global de TI da GLEIF, à medida que a equipe de TI se esforça para tornar os dados LEI prontamente disponíveis para seus usuários. Este primeiro número oferece uma visão geral sobre as mais recentes atualizações no API de download do arquivo Golden Copy e sua importância para alcançar a escalabilidade.
Autor: Christoph Schneider
Data: 2022-09-30
Visualizações:
No centro da operação da GLEIF, há um compromisso em fornecer, de maneira acessível e transparente, serviços de dados e identificação de entidades jurídicas. Uma robusta infraestrutura global de TI que assegura que todos os consumidores de dados no Global LEI System consigam integrar, acessar e utilizar de maneira fácil os dados LEI em múltiplas plataformas e sistemas é fundamental para isso.
O departamento de TI da GLEIF trabalha de maneira incessante para assegurar que sua infraestrutura global ofereça a melhor experiência de usuário possível, atualizando e refinando constantemente à medida que o Global LEI System cresce. A atualização mais recente nesse processo analisa o API de download do arquivo Golden Copy, que será atualizado a partir de 10 de outubro. Os arquivos Golden Copy e os arquivos delta são atualizados pela GLEIF três vezes ao dia e garantem o acesso fácil às informações mais recentes sobre LEIs novos e atualizados. O API de download que faz a conexão é fundamental para muitas equipes de desenvolvimento que dependem de atualizações automáticas de dados para oferecer dados precisos e oportunos para suas organizações. A alteração mais recente no API de download de arquivos Golden Copy ajudará os usuários a alcançar melhor escalabilidade e confiabilidade enquanto superam os gargalos de desempenho relacionados a downloads de arquivos fornecidos diretamente pelo API.
Quem será afetado por essa atualização?
Essa atualização resultará em um redirecionamento para o caminho direto de arquivo em vez de baixar direto do ponto de extremidade de API. As equipes que usam URLs de API de download de arquivos Golden Copy que resultam em um download direto de arquivo (ex.: https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) precisarão atualizar configurações de atualização em sintonia com essa mudança. Caso você esteja usando o API dessa maneira, sinalize esta atualização para a sua equipe técnica, a fim de assegurar que o redirecionamento funcione conforme o esperado.
Observe que, os domínios abaixo são afetados devido a essa futura atualização:
O API de download de arquivos Golden Copy oferece vários pontos de extremidade convenientes de API para baixar os arquivos Golden Copy (delta) diretamente baseados em um padrão de data de publicação ou na palavra-chave especial “latest”. Para maiores informações, consulte o Manual do Usuário e a Especificação de Arquivos Delta e Golden Copy da GLEIF. Um link pode ser encontrado no final deste artigo.
Atualmente, a invocação de um ponto de extremidade de API de download resultará em um download direto de arquivo (código de resposta 200 HTTP). Um exemplo baseado na URL do cliente (cURL) é mostrado abaixo:
Curl https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv
# HTTP/1.1 200 OK
E, após a data sugerida (2022-10-10), todas as solicitações de API serão redirecionadas para o caminho de download direto de arquivo (código de resposta 302 HTTP com um cabeçalho Location). Um exemplo baseado na URL do cliente (cURL) é mostrado abaixo:
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
No exemplo acima baseado na URL do cliente, a única mudança necessária é a adição de sinalização do local (-L ou --location) para assegurar que o novo local redirecionado seja seguido. Esse comportamento pode ser padrão ou pode precisar ser configurado ou tratado de maneira diferente com base no cliente de HTTP usado. Todos os consumidores de dados deveriam assegurar que os clientes/aplicativos de HTTP sigam e lidem de maneira apropriada com os redirecionamentos, conforme o mostrado acima.
Como equipes relevantes podem configurar a atualização?
Prepare e teste o seu sistema antes que a mudança seja disponibilizada. O código de status de redirecionamento HTTP 302 será introduzido, e os sistemas existentes precisam ser atualizados para apoiar o novo comportamento de uma maneira compatível com o futuro por meio de qualquer um dos seguintes métodos:
(Recomendado) Certifique-se de que o seu cliente/aplicativo de HTTP siga e trate dos redirecionamentos de maneira apropriada. Esse comportamento pode ser padrão ou pode precisar ser configurado ou tratado de maneira diferente com base no cliente de HTTP usado.
Atualize manualmente o seu sistema para entender de maneira adicional as respostas HTTP 302 e inspecione o cabeçalho Location, para seguir a URL de download direto de arquivo.
Existe um ambiente de teste temporário disponível?
A GLEIF forneceu aos consumidores de dados um ambiente de teste temporário, para que eles verifiquem se seus sistemas funcionarão com o novo comportamento e assegurem que redirecionamentos para o download direto de arquivo sejam seguidos. Isso apagará com facilidade a transição para o novo comportamento de redirecionamento.
Encontre abaixo os exemplos de ambiente de teste temporário que exiba o novo comportamento de redirecionamento:
Observe que esse ambiente de teste apenas apoia a data de publicação 19990101-0000, mas a mudança se aplicará a todos os padrões, inclusive a palavra-chave especial “latest” (ex.: …/publishes/lei2/latest.csv). Além disso, o ambiente de teste é um retrato de exemplo de um subgrupo dos dados de Golden Copy somente para fins de demonstração. Ele não tem o propósito de ser realmente usado, e o ambiente será desativado após o novo comportamento de API de Golden Copy ser disponibilizado.
A GLEIF encoraja o engajamento com consumidores de dados em todo o Global LEI System. Caso você tenha uma pergunta com relação à mais recente atualização ou queira discutir maneiras pelas quais a GLEIF pode ajudar a sua equipe para aproveitar o poder do LEI, entre em contato com info@gleif.org.
Para se manter atualizado sobre os mais recentes desenvolvimentos técnicos da equipe de TI da GLEIF, clique aqui para assinar o boletim informativo de notificações técnicas.
Termos principais:
API - API significa Interface de Programação de Aplicativo. Uma API é um conjunto de definições e protocolos que permite que programas de computador se comuniquem entre si por meio da Internet.
Ponto de extremidade - Um ponto de extremidade é um local que recebe solicitações da web. Uma API é uma coleção de pontos de extremidade.
Solicitação de API - Uma chamada, ou solicitação, de API é uma mensagem enviada para um ponto de extremidade (o servidor) pedindo para que uma API forneça um serviço ou informação.
Resposta de API - Os dados de resposta recebidos de uma API para fornecer um serviço ou informação.
Códigos de status de resposta HTTP - Essa é uma lista de códigos de status de resposta do Hypertext Transfer Protocol (HTTP). Códigos de status são emitidos por um servidor em resposta a uma solicitação de API feita por um ponto de extremidade, o servidor. Cada código de status tem um significado específico.
Arquivos Golden Copy - Arquivos incluindo LEIs e dados de referência relacionados carregados pelos emissores de LEI para a GLEIF.
Arquivos Delta - Os arquivos delta identificam apenas LEIs emitidos recentemente e/ou revisões nos dados de referência de um LEI historicamente informados em um Arquivo Golden Copy, que foram publicados antes (oito horas antes, 24 horas antes, sete dias antes e com o maior sendo 31 dias antes).
Serviços da GLEIF - Um conjunto de serviços fornecidos para o público e os nossos parceiros, a fim de assegurar integridade operacional em todo o Global LEI System.
Caso queira comentar uma postagem no blog, identifique-se usando seu nome e sobrenome. Seu nome aparecerá ao lado de seu comentário. Endereços de e-mail não serão publicados. Note que ao acessar ou contribuir com o fórum de discussão, você concorda com os termos da Política de Uso do Blog da GLEIF, portanto, leia-a com atenção.
Christoph Schneider é Diretor de Desenvolvimento e Operações de TI da Global Legal Entity Identifier Foundation (GLEIF). Em junho de 2017, Christoph ingressou na International Organization for Standardization (ISO) como colíder do Comitê Técnico 68 do Grupo Consultivo Técnico sobre FinTech (ISO TC 68 FinTech TAG). Ele tem vasta experiência no desenvolvimento e implantação de soluções na área de tecnologia financeira. Christoph é mestre em Sistemas de Informações Empresariais pela Technische Universität Darmstadt, na Alemanha.
