Hal Teknis #1: Pembaruan TI di Seluruh Sistem LEI Global & API Unduhan File Salinan Emas

Dalam seri blog baru ini, Christoph Schneider, Kepala Pengembangan dan Operasi TI di GLEIF, menjelaskan pembaruan teknis terbaru yang ada di seluruh infrastruktur TI global GLEIF seiring dengan upaya tim TI untuk memudahkan ketersediaan data LEI bagi penggunanya. Bagian pertama ini memberikan ikhtisar tentang pembaruan terbaru untuk API unduhan file Salinan Emas dan pentingnya untuk mencapai skalabilitas.

---

---

Inti operasi GLEIF adalah komitmen untuk memberikan transparansi dan aksesibilitas pada identifikasi badan hukum dan layanan data. Kuncinya adalah infrastruktur TI global yang kuat yang memastikan semua konsumen data di Sistem LEI Global dapat dengan mudah mengintegrasikan, mengakses, dan memanfaatkan data LEI di berbagai platform dan sistem.

Departemen TI GLEIF bekerja tanpa lelah untuk memastikan bahwa infrastruktur globalnya menawarkan pengalaman pengguna terbaik, terus memperbarui dan menyempurnakan seiring dengan pertumbuhan Sistem LEI Global. Pembaruan terkini dalam proses ini berkaitan dengan API Unduhan File Salinan Global yang akan diperbarui pada 10 Oktober. File Salinan Emas dan file delta diperbarui oleh GLEIF tiga kali sehari dan memastikan akses yang mudah ke informasi terkini mengenai LEI yang baru dan diperbarui. API Unduhan yang terhubung sangat penting bagi banyak tim pengembangan yang mengandalkan pembaruan data otomatis untuk memberikan data yang akurat dan tepat waktu ke organisasi mereka. Perubahan terbaru pada API Unduhan File Salinan Emas akan membantu pengguna untuk mencapai skalabilitas dan keandalan yang lebih baik sekaligus mengatasi kemacetan kinerja yang terkait dengan unduhan file yang dilayani langsung oleh API.

Siapa yang akan terdampak oleh pembaruan ini?

Pembaruan ini akan menghasilkan pengalihan ke jalur file langsung, bukan unduhan langsung dari titik akhir API. Tim yang menggunakan URL API Unduhan File Salinan Emas yang menghasilkan unduhan file langsung (misalnya, https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) harus memperbarui konfigurasi sesuai dengan perubahan ini. Jika Anda menggunakan API dengan cara ini, sampaikan pembaruan ini ke tim teknis Anda untuk memastikan bahwa pengalihan akan berfungsi seperti yang diharapkan.

Perhatikan bahwa domain di bawah ini terkena dampak perubahan mendatang ini:

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

Perubahan ini tidak akan memengaruhi tim yang menggunakan URL unduhan file langsung yang tercantum dalam respons API, yang sudah menggunakan jalur file langsung di bawah “/storage” (misalnya, https://goldencopy.gleif.org/storage/golden-copy-files/2022/06/01/642510/20220601-0000-gleif-goldencopy-lei2-golden-copy.csv.zip)

Bagaimana perubahan ini terlihat dalam praktik?

API Unduhan File Salinan Emas menyediakan beberapa titik akhir API yang mudah untuk mengunduh file Salinan Emas (delta) secara langsung berdasarkan pola tanggal publikasi atau kata kunci “latest” khusus. Untuk informasi lebih lanjut, lihat Spesifikasi dan Panduan Pengguna File Salinan Emas dan Delta GLEIF, tautan dapat ditemukan di akhir artikel ini.

Saat ini, permintaan titik akhir API unduhan akan menghasilkan unduhan file langsung (kode respons HTTP 200). Contoh berbasis curl ditunjukkan di bawah ini:

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

Dan setelah tanggal yang disarankan (2022-10-10), semua permintaan API akan dialihkan ke jalur unduhan file langsung (kode respons HTTP 302 dengan header Location). Contoh berbasis curl ditunjukkan di bawah ini:

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

Dalam contoh berbasis curl di atas, satu-satunya perubahan yang diperlukan adalah penambahan tanda lokasi (-L atau --location) untuk memastikan bahwa lokasi pengalihan baru diikuti. Perilaku tersebut mungkin bersifat default atau mungkin perlu dikonfigurasi atau ditangani secara berbeda berdasarkan klien HTTP yang digunakan. Semua konsumen data harus memastikan klien/aplikasi HTTP masing-masing mengikuti dan menangani pengalihan dengan benar, seperti yang ditunjukkan di atas.

Bagaimana tim terkait dapat mengonfigurasi pembaruan?

Persiapkan dan uji sistem Anda sebelum perubahan diluncurkan. Kode status pengalihan HTTP 302 akan diluncurkan, dan sistem yang ada harus diperbarui untuk mendukung perilaku baru menggunakan cara yang kompatibel dengan versi seterusnya melalui salah satu metode berikut:

1. (Disarankan) Pastikan klien/aplikasi HTTP Anda mengikuti dan menangani pengalihan dengan benar. Perilaku ini mungkin bersifat default atau mungkin perlu dikonfigurasi atau ditangani secara berbeda berdasarkan klien HTTP yang digunakan.
2. Perbarui sistem Anda secara manual untuk lebih memahami respons HTTP 302 dan periksa header Location untuk mengikuti URL unduhan file langsung.

Apakah ada lingkungan pengujian sementara yang tersedia?

GLEIF telah menyediakan lingkungan pengujian sementara bagi konsumen data untuk memeriksa apakah sistem mereka akan berfungsi dengan perilaku baru dan untuk memastikan bahwa pengalihan ke unduhan file langsung diikuti. Ini akan memudahkan transisi ke perilaku pengalihan baru.

Temukan contoh lingkungan pengujian sementara di bawah ini yang menunjukkan perilaku pengalihan baru:

• 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

Perhatikan bahwa lingkungan pengujian ini hanya mendukung tanggal publikasi 19990101-0000, tetapi perubahan akan berlaku untuk semua pola, termasuk kata kunci “latest” khusus (misalnya, …/publishes/lei2/latest.csv). Selanjutnya, lingkungan pengujian adalah contoh snapshot dari subset data Salinan Emas hanya untuk tujuan peragaan. Ini tidak dimaksudkan untuk penggunaan sebenarnya, dan lingkungan akan dinonaktifkan setelah perilaku API Salinan Emas baru diluncurkan.

GLEIF mendorong keterlibatan dengan konsumen data di seluruh Sistem LEI Global. Jika Anda memiliki pertanyaan tentang pembaruan terbaru atau ingin mendiskusikan cara GLEIF dapat mendukung tim Anda memanfaatkan kecanggihan LEI, silakan hubungi info@gleif.org.

Untuk mengikuti semua perkembangan teknis terbaru dari tim TI GLEIF, klik di sini untuk berlangganan buletin pemberitahuan teknis.

Istilah penting:

• API - API adalah singkatan dari Application Programming Interface (Antarmuka Pemrograman Aplikasi). API adalah seperangkat definisi dan protokol yang memungkinkan program komputer untuk berkomunikasi satu sama lain melalui world wide web.
• Titik Akhir - Titik akhir adalah lokasi yang menerima permintaan web. API adalah kumpulan titik akhir.
• Permintaan API - Panggilan API, atau permintaan API, adalah pesan yang dikirim ke titik akhir (server) yang meminta API untuk menyediakan layanan atau informasi.
• Respons API - Data respons yang diterima dari API untuk menyediakan layanan atau informasi.
• Kode status respons HTTP - Ini adalah daftar kode status respons Hypertext Transfer Protocol (HTTP). Kode status diterbitkan oleh server sebagai respons atas permintaan API yang dibuat ke titik akhir atau server. Setiap kode status memiliki arti tertentu.
• File Salinan Emas - File termasuk LEI dan data referensi terkait yang diunggah oleh penerbit LEI ke GLEIF.
• File Delta - File delta hanya mengidentifikasi LEI yang baru diterbitkan dan/atau revisi terhadap data rujukan LEI yang secara historis dilaporkan dalam File Salinan Emas yang diterbitkan lebih awal (delapan jam lebih awal, 24 jam lebih awal, tujuh hari lebih awal, dan yang terbesar adalah 31 hari lebih awal).
• Layanan GLEIF - Serangkaian layanan yang diberikan kepada publik dan mitra kami untuk memastikan integritas operasional di seluruh Sistem LEI Global.

---