새 소식 공간 및 미디어 GLEIF 블로그

기술 정보 #1: 글로벌 LEI 시스템 및 단일 복제본 파일 다운로드 API 전반에 대한 IT 업데이트

이 새로운 블로그 시리즈에서 GLEIF의 IT 개발 및 운영 담당 대표인 크리스토프 슈나이더는 IT팀이 LEI 데이터를 사용자가 더 쉽게 사용할 수 있도록 만들기 위해 노력함에 따라 GLEIF의 글로벌 IT 인프라 전반에서 최근 이루어지고 있는 기술 업데이트에 대해 설명합니다. 이 첫 번째 글에서는 단일 복제본 파일 다운로드 API에 대한 최신 업데이트에 대한 개요와 함께 확장성 확보에 있어 이 업데이트가 가지는 중요성에 대해 이야기합니다.


저자: 크리스토프 슈나이더

  • 날짜: 2022-09-30
  • 읽음:

투명하고 접근 가능한 법인 식별 및 데이터 서비스를 제공하겠다는 약속은 GLEIF 운영의 핵심입니다. 여기에서 가장 중요한 부분은 글로벌 LEI 시스템에 속하는 모든 데이터 소비자가 여러 플랫폼과 시스템을 넘나들며 LEI 데이터를 쉽게 통합, 접근 및 활용할 수 있게 하는 강력한 글로벌 IT 인프라입니다.

GLEIF의 IT 부서는 글로벌 LEI 시스템이 성장함에 따라 지속적으로 업데이트와 개선을 수행함으로써 이 글로벌 인프라가 최고의 사용자 경험을 제공할 수 있도록 끊임없이 노력합니다. 이 과정에서 가장 최근의 업데이트는 10월 10일에 업데이트될 예정인 전역 복제본 파일 다운로드 API입니다. 단일 복제본 파일 및 델타 파일은 GLEIF에 의해 하루 세 번씩 업데이트되어 신규 및 업데이트된 LEI에 대한 최신 정보에 쉽게 액세스할 수 있게 합니다. 연결 다운로드-API는 정확하고 시기적절한 데이터를 조직에 제공하기 위해 자동 데이터 업데이트를 사용하는 많은 개발 팀에게 중요합니다. 단일 복제본 파일 다운로드-API의 최근 변경 사용 시, API가 직접 서비스하는 파일 다운로드와 관련된 성능 병목 현상을 극복함으로써 사용자에게 보다 나은 확장성과 신뢰성을 제공할 수 있습니다.

이 업데이트는 누구에게 영향을 줍니까?

이 업데이트는 API 엔드포인트에서 직접 다운로드하는 대신 직접 파일 경로로 리디렉션됩니다. 직접 파일 다운로드(예: https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) 가 되는 단일 복제본 파일 다운로드-API URL을 사용하는 팀은 이 변경에 맞춰 구성을 업데이트해야 합니다. API를 이러한 방식으로 사용하고 있다면 리디렉션이 예상대로 작동할 수 있도록 이 업데이트를 기술 팀에게 알리기 바랍니다.

이번 변경으로 인해 아래 도메인이 영향을 받게 됩니다.

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

API 응답에 열거된 직접 파일 다운로드 URL을 사용 중이며 이미 “/storage” 아래의 직접 파일 경로(예: https://goldencopy.gleif.org/storage/golden-copy-files/2022/06/01/642510/20220601-0000-gleif-goldencopy-lei2-golden-copy.csv.zip) 를 사용하는 팀에게는 이 변경이 영향을 미치지 않습니다

이 변경은 실제로 어떻게 보입니까?

단일 복제본 파일 다운로드-API는 게시 날짜 패턴 또는 특수 "latest" 키워드를 기준으로 단일 복제본(델타) 파일을 직접 다운로드하기 편한 여러 API 엔드포인트를 제공합니다. 자세한 내용은 GLEIF 단일 복제본 및 델타 파일 사양 및 사용 설명서를 참조하십시오. 링크는 이 문서의 끝에서 확인할 수 있습니다.

현재 다운로드 API 엔드포인트를 호출하면 직접 파일 다운로드(200 HTTP 응답 코드)가 됩니다. 컬 기반 예제는 아래와 같습니다.

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

제안된 날짜 (2022-10-10)가 지나면 모든 API 요청이 직접 파일 다운로드 경로(Location 헤더가 있는 302 HTTP 응답 코드)로 리디렉션됩니다. 컬 기반 예제는 아래와 같습니다.

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

위의 컬 기반 예제에서 새로 리디렉션된 위치를 팔로우하기 위해 필요한 유일한 변경사항은 위치 플래그(-L 또는 --location)를 추가하는 것입니다. 그러한 변경은 기본적으로 이루어질 수도 있고, 사용된 HTTP 클라이언트에 따라 서로 다르게 구성하거나 처리해야 할 수도 있습니다. 모든 데이터 소비자는 각자의 HTTP 클라이언트/응용프로그램이 위와 같이 리디렉트를 제대로 팔로우하고 처리하는지 확인해야 합니다.

관련 팀은 업데이트를 어떻게 구성할 수 있습니까?

변경이 적용되기 전에 시스템을 준비하고 테스트하십시오. HTTP 302 리디렉트 상태 코드가 도입되면 다음 중 한 가지 방법을 통해 포워딩 방식으로 새로운 변경을 지원할 수 있도록 기존 시스템을 업데이트해야 합니다.

  1. (권장) HTTP 클라이언트/응용프로그램이 리디렉트를 제대로 팔로우하고 처리하는지 확인합니다. 이 변경은 기본적으로 이루어질 수도 있고, 사용된 HTTP 클라이언트에 따라 서로 다르게 구성하거나 처리해야 할 수도 있습니다.
  2. 추가적으로 HTTP 302 응답을 이해하도록 시스템을 수동으로 업데이트하고 Location 헤더가 직접 파일 다운로드 URL을 팔로우하는지 확인합니다.

임시 테스트 환경을 사용할 수 있습니까?

GLEIF는 데이터 소비자가 시스템에서 새로운 변경이 작동하는지 확인하고 직접 파일 다운로드에 대한 리디렉트를 팔로우하도록 임시 테스트 환경을 제공합니다. 이를 통해 새로운 리디렉트 환경으로의 전환을 용이하게 수행할 수 있습니다.

새로운 리디렉트 동작을 보여주는 아래 임시 테스트 환경 예제를 참조하십시오.

이 테스트 환경은 게시 날짜로 19990101-0000만 지원하지만, 변경은 특수 "latest" 키워드(예: …/publishes/lei2/latest.csv)를 포함한 모든 패턴에 적용됩니다. 또한 테스트 환경은 데모용 단일 복제본 데이터의 하위 집합 스냅샷 예제입니다. 이는 실제 사용을 위한 것이 아니며, 새 단일 복제본 API 환경이 도입된 후에는 사용 중단됩니다.

GLEIF는 글로벌 LEI 시스템 전반에 대해 데이터 소비자가 참여할 것을 권장합니다. 최신 업데이트에 관한 질문이 있거나 고객 팀의 LEI 기능 활용에 대한 GLEIF의 지원 방식에 대한 논의는 info@gleif.org로 문의해 주십시오.

GLEIF의 IT 팀이 제공하는 최신 기술 개발에 대한 정보를 계속 얻으려면 여기를 클릭해 기술 정보 뉴스레터를 구독하십시오.

핵심 용어:

  • API - API는 애플리케이션 프로그래밍 인터페이스의 약자입니다. API는 컴퓨터 프로그램이 월드와이드웹을 통해 서로 통신할 수 있게 하는 정의 및 프로토콜의 집합입니다.
  • 엔드포인트 - 엔드포인트는 웹 요청을 수신하는 위치입니다. API는 엔드포인트의 모음입니다.
  • API 요청 - API 호출 또는 API 요청은 API의 서비스 또는 정보 제공을 요청하기 위해 엔드포인트(서버)에게 전송하는 메시지입니다.
  • API 응답 - 서비스 또는 정보 제공을 위해 API로부터 수신되는 응답 데이터입니다.
  • HTTP 응답 상태 코드 - 하이퍼텍스트 전송 프로토콜(HTTP) 응답 상태 코드 목록입니다. 상태 코드는 엔드포인트, 즉 서버가 수신한 API 요청에 대한 응답으로 서버가 발행하는 것입니다. 각 상태 코드는 고유한 의미를 갖고 있습니다.
  • 단일 복제본 파일 - LEI 발급자가 GLEIF에게 업로드한 LEI 및 관련 참조 데이터를 포함하고 있는 파일입니다.
  • 델타 파일 - 델타 파일은 새롭게 발행된 LEI 및/또는 이전(8시간 전, 24시간 전, 7일 전 및 최장 31일 전)에 발행된 단일 복제본 파일 상에 보고된 LEI의 기준 데이터에 대한 개정본만 식별합니다.
  • GLEIF 서비스 - 글로벌 LEI 시스템 상의 운영 무결성 보장을 위해 대중과 파트너 모두에게 제공하는 서비스 집합입니다.

블로그 게시물에 댓글을 추가하려면 영어 GLEIF 웹사이트 블로그 기능을 이용하여 댓글을 추가해주십시오. 이름과 성을 써서 자신이 누구인지 밝혀주십시오. 이름은 댓글 옆에 표시됩니다. 이메일 주소는 공개되지 않습니다. 토론 게시판을 이용하거나 게시물을 등록하는 것은 GLEIF 블로그 정책 약관을 준수하는 것에 동의하는 행위이므로, 해당 약관을 주의 깊게 읽어주십시오.



이전 GLEIF 블로그 게시물 전부 읽기 >
저자 소개:

크리스토프 슈나이더는 Global Legal Entity Identifier Foundation(GLEIF)의 IT 개발 및 운영 책임자입니다. 2017년 6월, 그는 국제 표준화 기구(ISO)에서 디지털 신원 업무를 담당하는 기술 위원회 68 FinTech 기술 자문 그룹(ISO TC 68 FinTech TAG)의 공동 대표로 활동하였습니다. 그는 금융 기술 솔루션의 개발 및 구현과 관련된 광범위한 경험을 보유하고 있습니다. 크리스토프는 다름슈타트 공과대학교에서 비즈니스 정보 시스템 전공으로 공학 석사 학위를 받았습니다.


이 기사에 대한 태그:
데이터 관리, GLEIF 단일 복제본 파일 및 델타 파일, GLEIF 서비스, 기술 업데이트