Teknik Bilgi Notu 1: Global LEI Sistemi ve Altın Kopya Dosyası İndirme API'sindeki Güncellemeler

Bu yeni blog serisinde, GLEIF'te BT Geliştirme ve Operasyonları Başkanı Christoph Schneider, BT ekibi LEI verilerinin kullanıcılar için daha kolayca ulaşılabilir olması adına çaba gösterirken GLEIF'in global BT altyapısında gerçekleşen teknik güncellemeleri açıklıyor. Bu ilk bölüm, Altın Kopya dosya indirme API'sine ve bunun ölçeklenebilirliğe erişmedeki önemine genel bir bakış sağlıyor.

---

---

GLEIF faaliyetlerinin merkezinde şeffaf ve erişilebilir tüzel kişilik tanımlama ve veri hizmetleri sağlama taahhüdü bulunur. Bu, Global LEI Sistemindeki tüm veri tüketicilerinin LEI verilerini birden fazla platformda ve sistemde kolayca entegre edebilmeleri, bu verilere erişebilmeleri ve bunları kullanabilmeleri için sağlam, global bir BT altyapısı ile mümkündür.

GLEIF'in BT departmanı, global altyapısının mümkün olan en iyi kullanıcı deneyimini sunmak ve Global LEI Sistemi büyürken sürekli olarak güncellemek ve rafine hale gelmesini sağlamak amacıyla yorulmadan çalışır. Global Kopya Dosyası İndirme API'si hakkındaki bu sürecin son güncellemesi, 10 Ekim itibarıyla yapılacaktır. GLEIF tarafından günde üç kez güncellenen Altın Kopya Dosyaları ve delta dosyaları, yeni ve güncellenmiş LEI'ler hakkında en son bilgilere kolay erişim sağlar. Bağlantılı İndirme API'si, kuruluşlarına doğru ve zamanında veri sağlamak amacıyla otomatik veri güncellemeye ihtiyaç duyan geliştirme ekipleri için kritik önemdedir. Altın Kopya Dosyaları İndirme API'sindeki son değişiklik, kullanıcıların performansı etkileyen dosya indirme ile ilgili engelleri aşarak daha iyi ölçeklenebilirlik ve güvenilirliğe erişmesini sağlayacak.

Bu güncelleme kimleri etkileyecek?

Bu güncelleme, API uç noktasından doğrudan indirme yerine doğrudan dosya yoluna yeniden yönlendirme sağlayacak. Doğrudan dosya indirmeyle sonuçlanan Altın Kopya Dosyaları İndirme API'si URL'lerini (ör. https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) kullanan ekiplerin bu değişiklik doğrultusunda yapılandırmaları güncellemeleri gerekecek. API'yi bu şekilde kullanıyorsanız lütfen yeniden yönlendirmenin beklenen şekilde çalışması için bu güncellemeyi teknik ekibinize iletmek üzere işaretleyin.

Lütfen aşağıdaki etki alanlarının yakında gerçekleşecek bu değişiklikten etkileneceğini unutmayın:

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

Bu değişiklik, API yanıtlarında listelenen ve "/storage" altında doğrudan dosya yolunu kullanan doğrudan indirme URL'leri (ör. https://goldencopy.gleif.org/storage/golden-copy-files/2022/06/01/642510/20220601-0000-gleif-goldencopy-lei2-golden-copy.csv.zip) ile çalışan ekipleri etkilemeyecek

Bu değişiklik uygulamada nasıl görünecek?

Altın Kopya Dosyaları İndirme API'si, yayımlanma tarihi deseni veya özel bir "latest" anahtar sözcüğe dayanan Altın Kopya (delta) dosyalarının indirilmesi için pek çok kullanışlı API uç noktası sunar. Daha fazla bilgi edinmek için lütfen GLEIF Altın Kopya ve Delta Dosyaları Şartnamesi ve Kullanım Kılavuzuna bakın. Bu makalenin sonunda bağlantıyı bulabilirsiniz.

Şu anda indirme API uç noktasının yürütülmesi, doğrudan dosya indirmeyle sonuçlanacaktır (200 HTTP yanıt kodu). Aşağıda cURL tabanlı bir örnek gösterilmiştir:

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

Önerilen tarihten sonra (2022-10-10) tüm API istekleri, doğrudan dosya indirme yoluna yeniden yönlendirilecektir (Location başlıklı bir 302 HTTP yanıt kodu). Aşağıda cURL tabanlı bir örnek gösterilmiştir:

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

Yukarıdaki cURL tabanlı örnekte gerekli olan tek değişiklik, yeniden yönlendirilen yeni konumun takip edildiğinden emin olmak için konum bayrağının (-L veya --location) eklenmesidir. Bu tür bir davranış varsayılan olabilir veya kullanılan HTTP istemcisine göre daha farklı bir şekilde yapılandırılması veya işlenmesi gerekebilir. Veri tüketicilerinin tamamı, kendilerine ait HTTP istemcilerinin/uygulamalarının yeniden yönlendirmeleri aşağıda gösterildiği gibi doğru bir şekilde takip edip işlediğinden emin olmalıdır.

İlgili ekipler güncellemeyi nasıl yapılandırabilir?

Değişiklik kullanıma sunulmadan önde sisteminizi hazırlayın ve test edin. HTTP 302 yeniden yönlendirme durum kodu kullanıma sunulacaktır. Ayrıca mevcut sistemlerin bu yeni davranışı ileriye dönük olarak uyumlu bir şekilde destekleyebilmesi için aşağıdaki yöntemlerden herhangi biriyle güncellenmesi gerekmektedir:

1. (Önerilen) HTTP istemcinizin/uygulamanızın yeniden yönlendirmeleri doğru bir şekilde takip edip işlediğinden emin olun. Bu davranış varsayılan olabilir veya kullanılan HTTP istemcisine göre daha farklı bir şekilde yapılandırılması veya işlenmesi gerekebilir.
2. Ek olarak HTTP 302 yanıtlarını anlamak ve doğrudan dosya indirme URL'sini takip etmek amacıyla Location başlığını denetlemek için sisteminizi manuel olarak güncelleyin.

Geçici bir test ortamı bulunuyor mu?

GLEIF, veri tüketicilerinin sistemlerinin yeni davranışla uyumlu olarak çalışıp çalışmayacağını test edebilmeleri ve doğrudan dosya indirmeye yeniden yönlendirmelerin takip edildiğinden emin olmaları için geçici bir test ortamı sağlamıştır. Bu sayede yeni yeniden yönlendirme davranışına geçişleri kolaylaşmış olur.

Aşağıda, yeni yeniden yönlendirme davranışını gösteren geçici test ortamı örneklerini bulabilirsiniz:

• https://goldencopy-next.gleif.org/api/v2/golden-copies/publishes/lei2/19990101-0000.csv
• https://goldencopy-next.gleif.org/api/v2/golden-copies/publishes/lei2/19990101-0000.xml
• https://goldencopy-next.gleif.org/api/v2/golden-copies/publishes/lei2/19990101-0000.json?delta=IntraDay

Lütfen bu test ortamının yalnızca 19990101-0000 yayımlanma tarihini desteklediğini ancak değişikliğin özel "latest" anahtar sözcük (ör. …/publishes/lei2/latest.csv) dahil olmak üzere tüm desenlere uygulanabileceğini unutmayın. Ayrıca, test ortamı, Altın Kopya verilerinin yalnızca gösterim amacıyla kullanılan bir alt kümesinin örnek anlık görüntüsüdür. Fiili kullanıma yönelik değildir ve bu ortam, yeni Altın Kopya API davranışı kullanıma sunulduktan sonra hizmet dışı bırakılacaktır.

GLEIF, Global LEI Sistemindeki veri tüketicileriyle etkileşimi teşvik eder. Son güncellemeyle ilgili bir sorunuz varsa veya GLEIF'in ekibinizin LEI gücünden yararlanmasını nasıl destekleyebileceğini tartışmak isterseniz lütfen info@gleif.org adresinden bizimle iletişime geçin.

GLEIF BT ekibinin yayımladığı tüm güncel teknik gelişmelerden haberdar olmak için buraya tıklayarak teknik bildirim bültenine abone olun.

Anahtar terimler:

• API: API, Application Programming Interface (Uygulama Programlama Arayüzü) anlamına gelir. API, bilgisayar programlarının dünya çapında ağ üzerinden birbirleriyle iletişim kurmasına olanak tanıyan bir dizi tanım ve protokoldür.
• Uç Nokta: Uç nokta, web istekleri alan bir konumdur. API, uç noktaların bir birleşimidir.
• API İsteği: Bir API çağrısı veya API isteği, API'den bir hizmet veya bilgi sağlamasını isteyen bir uç noktaya (sunucuya) gönderilen mesajdır.
• API Yanıtı: Bir hizmet veya bilgi sağlamak için bir API'den alınan yanıt verileridir.
• HTTP yanıt durumu kodları: Bu, Köprü Metni Aktarma Protokolü (HTTP) yanıt durumu kodlarının bir listesidir. Durum kodları, sunucuya yapılan bir API isteğine yanıt olarak sunucu tarafından bir uç noktaya verilir. Her durum kodunun belirli bir anlamı vardır.
• Altın Kopya Dosyaları: LEI tahsis eden kurumlar tarafından GLEIF'e yüklenen LEI'leri ve ilgili referans verilerini içeren dosyalardır.
• Delta Dosyaları: Delta dosyaları sadece yeni tahsis edilmiş LEI'leri ve/veya daha önce (sekiz saat önce, 24 saat önce, yedi gün önce ve en fazla 31 gün önce) yayımlanmış Altın Kopya Dosyasında raporlanan LEI referans verilerinin revizyonlarını belirtilir.
• GLEIF Hizmetleri: Global LEI Sistemi genelinde operasyonel bütünlüğü sağlamak için hem kamuoyuna hem de iş ortaklarımıza sağladığımız bir dizi hizmettir.

---