Технические новости №1: Обновления Глобальной системы LEI и API загрузки файлов золотой копии
В этой новой серии публикаций Кристоф Шнайдер, руководитель отдела развития информационных технологий и операций фонда GLEIF, рассказывает о последних технических обновлениях, внедренных отделом информационных технологий в глобальную ИТ-инфраструктуру GLEIF в рамках усилий по упрощению пользовательского доступа к данным LEI. В этой первой публикации речь пойдет о последних обновлениях API для загрузки файлов золотой копии и об их важности для обеспечения масштабируемости.
Автор: Кристоф Шнайдер
Дата: 2022-09-30
Просмотров:
В своей деятельности фонд GLEIF стремится к обеспечению прозрачности и доступности услуг по идентификации юридических лиц и информационного обслуживания. Для этого необходима эффективная ИТ-инфраструктура, позволяющая всем пользователям данных в Глобальной системе LEI свободно получать, интегрировать и использовать данные LEI для различных платформ и систем.
Отдел информационных технологий фонда GLEIF неустанно работает над тем, чтобы наша глобальная инфраструктура обеспечивала максимальное удобство для пользователей, постоянно обновляя и совершенствуя Глобальную систему LEI. Последнее обновление в рамках этого процесса касается API для загрузки файлов золотой копии и будет выпущено 10 октября. Файлы золотой копии и дельта-файлы GLEIF обновляются трижды в день и обеспечивают быстрый доступ к самой последней информации о новых и продленных кодах LEI. API для загрузки файлов критически важен для многих команд разработчиков, которые нуждаются в точных и своевременных данных и полагаются на процесс автоматического обновления данных для их получения. Последнее обновление в API для загрузки файлов золотой копии поможет пользователям добиться лучшей масштабируемости и большей надежности, а также позволит справиться с трудностями, снижающими скорость загрузки файлов при помощи данного API.
Кого затронет данное обновление?
После обновления запросы на загрузку файлов будут переадресовываться к прямому пути файла вместо прямой загрузки с конечной точки API. Команды, использующие URL-адреса API загрузки файлов золотой копии для скачивания файлов по прямым ссылкам (например, https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv), должны будут соответствующим образом обновить свои конфигурации. Если вы таким образом используете данный API, сообщите об этом обновлении своим техническим специалистам, чтобы они обеспечили надлежащую работу функции переадресации.
Обратите внимание, что грядущее обновление затронет следующие домены:
API загрузки файлов золотой копии предоставляет несколько удобных конечных точек для загрузки напрямую файлов золотой копии (дельта-файлов), с использованием шаблонов поиска по дате публикации или по ключевому слову «latest» (самый последний). Более подробную информацию см. в документе «Спецификация и руководство пользователя файлов золотой копии и дельта-файлов GLEIF», ссылку на который можно найти в конце данной статьи.
В настоящий момент обращение к конечной точке API загрузки позволит скачивать файл напрямую (код HTTP-ответа 200). См. пример ниже:
Curl https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv
# HTTP/1.1 200 OK
После указанной даты (2022-10-10), все запросы к API будут перенаправляться на путь для прямого скачивания файлов (код HTTP-ответа 302 с заголовком Location). См. пример ниже:
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, и существующие системы необходимо будет обновить, чтобы они могли поддерживать новую процедуру с восходящей совместимостью. Для обновления используйте один из следующих методов:
(Рекомендуется) Убедитесь, что HTTP-клиент/приложение верно следует по путям переадресации и верно их обрабатывает. Такая процедура может быть процедурой по умолчанию или же ее будет необходимо настроить отдельно в зависимости от используемого HTTP-клиента.
Вручную обновите свою систему, чтобы она могла понимать HTTP-ответы 302 и распознавать заголовки Location для перехода по URL-пути для прямой загрузки файлов.
Доступна ли временная среда для тестирования?
Фонд GLEIF предоставляет пользователям данных временную среду для тестирования, чтобы они могли проверить, насколько хорошо их системы работают с новой процедурой и следуют ли они переадресациям для прямого скачивания файлов. Это значительно облегчит переход на новую процедуру переадресации.
Ниже приведены примеры того, как новая процедура переадресации работает во временной среде для тестирования:
Обратите внимание, что данная среда для тестирования поддерживает лишь даты публикации 19990101-0000, но обновление затронет все шаблоны поиска, в том числе и по ключевому слову «latest» (например, …/publishes/lei2/latest.csv). Данные золотой копии в тестовой среде являются примером и предназначены исключительно для демонстрационных целей. Они не предназначены для фактического использования, а сама тестовая среда будет свернута сразу после успешного внедрения новой процедуры API золотой копии.
Фонд GLEIF стремится наладить взаимодействие с пользователями данных во всей Глобальной системе LEI. Если у вас возникли вопросы о последнем обновлении или если вы хотите обсудить поддержку вашей команды со стороны GLEIF по вопросам, касающимся LEI, обращайтесь по адресу info@gleif.org.
Нажмите здесь, чтобы подписаться на информационную рассылку с техническими уведомлениями и получать самую последнюю информацию о последних разработках отдела информационных технологий фонда GLEIF.
Основные термины:
API — аббревиатура API означает Application Programming Interface (интерфейс прикладного программирования). API представляет собой набор определений и протоколов, позволяющий компьютерным программам коммуницировать между собой через Интернет.
Конечная точка — конечной точкой называется локация, принимающая веб-запросы. API представляет собой набор конечных точек.
Запрос API — вызов API, или запрос API — это сообщение, которое отправлено в конечную точку (сервер) и запрашивает у API доступ к определенной услуге или информации.
Ответ API — данные, полученные от API в ответ на запрос услуги или информации.
Коды состояний HTTP-ответов — это перечень кодов состояния для ответов по протоколу HTTP. Коды состояний генерируются сервером в ответ на запросы API, полученные в конечной точке (на сервере). Каждый код состояния имеет конкретное значение.
Файлы золотой копии — файлы с кодами LEI и соответствующей справочной информацией, загруженные на платформу фонда GLEIF организациями, выдающими коды LEI.
Дельта-файлы — дельта-файлы позволяют находить только новые выданные коды LEI или изменения справочных данных кодов LEI, изначально указанные в ранее опубликованном файле золотой копии (за последние 8 часов, за последние 24 часа, за последние 7 дней, за последний 31 день).
Услуги GLEIF — набор услуг, которые наш фонд предоставляет как общественности, так и своим партнерам для обеспечения операционной целостности в Глобальной системе LEI.
Чтобы оставить свои комментарии к публикациям блога, откройте блог GLEIF на английском языке и опубликуйте свой комментарий. Укажите свое имя и свою фамилию. Ваше имя будет отображаться рядом с вашими комментариями. Адрес электронной почты публиковаться не будет. Обратите внимание, что, получая доступ к форуму и оставляя свои комментарии, вы соглашаетесь соблюдать условия Правил ведения блогов GLEIF, поэтому внимательно прочитайте их.
Кристоф Шнайдер возглавляет отдел развития информационных технологий и операций фонда Global Legal Entity Identifier Foundation (GLEIF). В июне 2017 года Кристоф начал работать в качестве одного из руководителей Технической консультативной группы по финансовым технологиям при техническом комитете 68 (ISO TC 68 FinTech TAG) в Международной организации по стандартизации (ISO), занимаясь решением проблем, связанных с цифровой идентификацией. Он обладает обширным опытом разработки и внедрения решений в сфере финансовых технологий. Кристоф получил степень магистра информационных систем для бизнеса в Дармштадтском техническом университете.
