新闻与媒体 GLEIF 博客

掌握技术 #1:整个全球 LEI 体系的 IT 更新和黄金副本文件下载应用程序编程接口

在这一新的博客系列中,GLEIF 的信息技术开发和运营主管 Christoph Schneider 阐述了 GLEIF 全球 IT 基础设施的最新技术更新,因为 IT 团队正在努力使 LEI 数据更容易为其用户所用。第一部分概述了黄金副本文件下载应用程序编程接口的最新更新,以及它对实现可扩展性的重要性。


作者: Christoph Schneider

  • 日期: 2022-09-30
  • 浏览数:

GLEIF 运作的核心是致力于提供透明和可获得的法人机构识别和数据服务。这方面的关键是一个强大的全球 IT 基础设施,以确保全球 LEI 体系中的所有数据消费者能够在多个平台和系统中轻松整合、访问和利用 LEI 数据。

GLEIF 的 IT 部门孜孜不倦地工作,以确保随着全球 LEI 体系的发展而不断更新和完善,其全球基础设施能够提供最好的用户体验。这个过程中的最新更新是将于 10 月 10 日更新的有关全球副本文件下载应用程序编程接口。GLEIF 每天会更新三次黄金副本文件和德尔塔文件,并确保方便地访问新的和更新后的 LEI 的最新信息。连接下载-应用程序编程接口对于许多依靠自动数据更新,以便为其组织提供准确、及时数据的开发团队而言至关重要。黄金副本文件下载应用程序编程接口的最新变化,将帮助用户实现更好的可扩展性和可靠性,同时消除与由应用程序编程接口直接提供的文件下载有关的性能瓶颈。

谁会受到这次更新的影响?

这一更新将导致重定向到直接文件路径,而不是从应用程序编程接口端点直接下载。使用黄金副本文件下载应用程序编程接口 URL 导致直接下载文件(如 https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) 的团队将需要根据这一变化来更新配置。如果您正在以这种方式使用应用程序编程接口,请向您的技术团队标记这一更新,以确保重定向会按预期进行。

请注意,以下领域会受到这一即将到来的变化的影响:

  • goldencopy.gleif.org
  • leidata-preview.gleif.org

这一变化不会影响使用应用程序编程接口响应中列出的直接文件下载 URL 的团队,它们已经使用了“/storage”下的直接文件路径(如 https://goldencopy.gleif.org/storage/golden-copy-files/2022/06/01/642510/20220601-0000-gleif-goldencopy-lei2-golden-copy.csv.zip

这一变化在实践中会如何体现?

黄金副本文件下载应用程序编程接口提供了几个方便的应用程序编程接口端点,可以根据发布日期模式或特殊的“latest”关键字直接下载黄金副本(德尔塔)文件。有关更多信息,请参考 GLEIF 黄金副本和德尔塔文件规范和用户手册,本文末尾处提供了相关链接。

目前,调用一个下载应用程序编程接口端点将导致直接的文件下载(200 HTTP 响应代码)。一个基于 curl 的示例如下所示:

Curl https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv
# HTTP/1.1 200 OK

而在建议的日期 (2022-10-10) 之后,所有的应用程序编程接口请求都将被重定向到直接的文件下载路径(302 HTTP 响应代码与 Location 标头)。一个基于 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

在上述基于 curl 的例子中,唯一需要更改的是增加位置标记(-L 或 --location),以确保新的重定向位置会被遵循。这种行为可能是默认的,也可能需要根据所使用的 HTTP 客户端进行配置或以不同方式处理。所有的数据消费者应该确保他们各自的 HTTP 客户端/应用程序正确地遵循和处理重定向,如上所示。

相关团队要如何配置更新?

在变更推出之前,准备并测试您的系统。HTTP 302 重定向状态代码将被引入,现有系统必须通过以下任何一种方法,以向前兼容的方式更新以支持新的行为:

  1. (建议)确保您的 HTTP 客户端/应用程序正确地遵循和处理重定向。此行为可能是默认的,也可能需要根据所使用的 HTTP 客户端进行配置或以不同方式处理。
  2. 手动更新您的系统,以便进一步了解 HTTP 302 响应,并检查 Location 标头以跟踪直接文件下载的 URL。

是否提供临时的测试环境?

GLEIF 为数据消费者提供了一个临时的测试环境,以检查他们的系统是否能使用新的行为工作,并确保重定向到直接文件下载。这样将方便向新的重定向行为过渡。

请在下面找到展示新重定向行为的临时测试环境实例:

请注意,该测试环境只支持发布日期 19990101-0000,但此变更将适用于所有模式,包括特殊的“latest”关键词(如…/publishes/lei2/latest.csv)。此外,测试环境是黄金副本数据子集的一个例子概貌,仅用于演示目的。它并不会投入实际使用,在新的黄金副本应用程序编程接口行为推出后,该环境就会被停用。

GLEIF 鼓励与整个全球 LEI 体系的数据消费者进行接触。如果您有关于最新更新的问题,或者想讨论 GLEIF 如何支持您的团队利用 LEI 的力量,请联系 info@gleif.org

要了解 GLEIF IT 团队的所有最新技术发展,请点击此处以订阅技术通知通讯。

主要术语:

  • API - API 是应用程序编程接口的英文缩写。API 由一组定义和协议组成,它允许计算机程序通过世界范围内的网络相互通信。
  • 端点 - 端点是一个接收网络请求的位置。一个 API 包含一系列的端点。
  • API 请求 - API 调用,也称为 API 请求,是向一个端点(服务器)发送的信息,要求 API 提供服务或信息。
  • API 响应 - 从 API 收到的提供服务或信息的响应数据。
  • HTTP 响应状态代码 - 这是一个超文本传输协议 (HTTP) 响应状态代码的列表。状态代码是由服务器发出的,以响应向一个端点、服务器发出的 API 请求。每个状态代码都有特定的含义。
  • 黄金副本文件 - 包括 LEI 发放机构上传到 GLEIF 的 LEI 和相关参考数据的文件。
  • 德尔塔文件 - 德尔塔文件仅指出新发放的 LEI,以及/或者历史上在下列更早时间(八个小时前、24 个小时前、七天前、或者最多 31 天前)发布的黄金副本文件中所报告 LEI 参考数据的修订。
  • GLEIF 服务 - 为公众和我们的合作伙伴提供的一套服务,以确保整个全球 LEI 体系的运作完整性。

如果您希望对博文进行评论,请使用您的姓名来识别自己。您的姓名将显示在您的评论旁。不会公布电子邮件地址。请注意,访问讨论区或在其中发帖即表示您同意遵守GLEIF 博客政策条款,因此请仔细阅读该条款。



阅读先前全部 GLEIF 博文 >
关于作者:

Christoph Schneider 是 Global Legal Entity Identifier Foundation (GLEIF) 的信息技术开发与运营主管。在 2017 年 6 月,Christoph 加入国际标准组织 (ISO),担任技术委员会 68 FinTech 技术咨询组 (ISO TC 68 FinTech TAG) 负责处理数字身份的工作流的共同领导者。他在开发和实施金融技术解决方案方面有极为丰富的经验。Christoph 拥有达姆施塔特工业大学商业信息系统的理学硕士学位。


此文章的标签:
数据管理, GLEIF 黄金副本文件和德尔塔(Delta)文件, GLEIF 服务, 技术更新