إشعار فني رقم 1: تحديثات تكنولوجيا المعلومات عبر نظام معرّفات الكيانات القانونية العالمي وتنزيل ملف واجهة برمجة تطبيقات النسخ الرسمية الرئيسية
في سلسلة المدونة الجديدة هذه، يشرح كريستوف شنايدر، رئيس تطوير تكنولوجيا المعلومات والعمليات في GLEIF، آخر التحديثات الفنية التي تحدث عبر البنية الأساسية العالمية لتكنولوجيا المعلومات لدى GLEIF حيث يبذل فريق تكنولوجيا المعلومات قصارى جهده لجعل بيانات معرّفات الكيانات القانونية متاحة بصفة مستمرة للمستخدمين. يوفر التثبيت الأول نظرة عامة على آخر تحديثات تنزيل ملف واجهة برمجة تطبيقات النسخة الرسمية الرئيسية وأهميته في تحقيق قابلية التوسع.
المؤلف: كريستوف شنايدر
التاريخ: 30-09-2022
مشاهَدات:
يمثل الالتزام بتوفير خدمات بيانات ومعرّفات كيانات قانونية تتسم بالشفافية وسهولة الوصول إليها محورًا أساسيًا من محاور التشغيل لدى GLEIF. والعامل الأساسي في تحقيق هذا هو توفر بنية أساسية عالمية قوية لتكنولوجيا المعلومات تضمن إمكانية قيام جميع مستخدمي البيانات في نظام معرّفات الكيانات القانونية العالمي بدمج بيانات معرّفات الكيانات القانونية والوصول إليها واستخدامها بسهولة عبر المنصات والأنظمة المتعددة.
يعمل قسم تكنولوجيا المعلومات لدى GLEIF بلا كلل لضمان توفير البنية الأساسية العالمية في GLEIF لأفضل تجربة مستخدم ممكنة والتحديث المستمر والتنقيح مع نمو نظام معرّفات الكيانات القانونية العالمي. يتعلق التحديث الأخير في هذه العملية بتنزيل ملف واجهة برمجة تطبيقات النسخة الرسمية الرئيسية، والذي سيتم تحديثه اعتبارًا من 10 أكتوبر. يتم تحديث ملفات النسخ الرسمية الرئيسية وملفات التحديثات بواسطة GLEIF ثلاث مرات في اليوم مع ضمان سهولة الوصول إلى أحدث المعلومات عن معرّفات الكيانات القانونية الجديدة والمحدثة. يعتبر تنزيل ملف واجهة برمجة التطبيقات المتصل من الأمور المهمة للغاية بالنسبة للعديد من فرق التطوير التي تعتمد على تحديثات البيانات التلقائية لتوفير البيانات الدقيقة في الوقت المناسب لمؤسساتها. إن التغيير الأخير على تنزيل ملفات واجهة برمجة تطبيقات النسخ الرسمية الرئيسية سيساعد المستخدمين في تحقيق قابلية التوسع والموثوقية بشكل أفضل مع التغلب على معوقات الأداء المتعلقة بتنزيلات الملفات التي تقدمها واجهة برمجة التطبيقات بشكل مباشر.
من الذي سيتأثر بهذا التحديث؟
سيؤدي هذا التحديث إلى إعادة التوجيه إلى مسار الملف المباشر بدلاً من التنزيل المباشر من نقطة نهاية واجهة برمجة التطبيقات. إن الفرق التي تستخدم عناوين URL الخاصة بتنزيل ملفات واجهة برمجة تطبيقات النسخ الرسمية الرئيسية التي تؤدي إلى تنزيل الملف المباشر (على سبيل المثال، https://goldencopy.gleif.org/api/v2/golden-copies/publishes/lei2/20220601-0000.csv) ستحتاج إلى تحديث التكوينات بما يتوافق مع هذا التغيير. إذا كنت تستخدم واجهة برمجة التطبيقات بهذه الطريقة، فيرجى إبلاغ الفريق الفني لديك بهذا التحديث للتأكد من أن عملية إعادة التوجيه ستعمل كما هو متوقع.
الرجاء ملاحظة أن المجالات التالية سوف تتأثر بسبب التغيير القادم:
يوفر تنزيل ملفات واجهة برمجة تطبيقات النسخ الرسمية الرئيسية العديد من نقاط نهاية واجهة برمجة التطبيقات الملائمة لتنزيل ملفات النسخ الرسمية الرئيسية (التحديثات) مباشرةً وفقًا لنمط تاريخ نشر أو الكلمة الرئيسية الخاصة "latest". للحصول على مزيد من المعلومات، الرجاء الرجوع إلى ملفات النسخ الرسمية الرئيسية وملفات تحديثات GLEIF - دليل المستخدم والمواصفات، ويمكنك العثور على الرابط في نهاية هذه المقالة.
سيؤدي حاليًا تنفيذ التنزيل من نقطة نهاية واجهة برمجة التطبيقات إلى تنزيل الملف المباشر (رمز الاستجابة 200 HTTP). فيما يلي مثال يستند إلى التكامل الخطي لمتجه:
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 -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). وعلاوة على ذلك، فإن بيئة الاختبار هي لقطة نموذجية لمجموعة فرعية من بيانات النسخ الرسمية الرئيسية لأغراض توضيحية فقط. وهي غير مخصصة للاستخدام الفعلي، وسيتم تفكيك البيئة بعد نشر سلوك واجهة برمجة تطبيقات النسخ الرسمية الرئيسية.
تشجع GLEIF على التفاعل مع مستخدمي البيانات عبر نظام معرّفات الكيانات القانونية العالمي. إذا كانت لديك أية استفسارات بشأن التحديث الأخير أو إذا كنت ترغب في مناقشة الطرق التي تستطيع أن تستخدمها GLEIF لدعم فريقك في الاستفادة من قوة معرّفات الكيانات القانونية، الرجاء التواصل معنا على info@gleif.org.
للاطلاع أولاً بأول على أحدث التطويرات الفنية من فريق تكنولوجيا المعلومات لدى GLEIF، انقر هنا للاشتراك في الرسالة الإخبارية للإشعارات الفنية.
المصطلحات الرئيسية:
API - تشير API إلى واجهة برمجة التطبيقات. واجهة برمجة التطبيقات هي مجموعة من التعريفات والبروتوكولات التي تتيح لبرامج الكمبيوتر الاتصال ببعضها البعض عبر شبكة الويب العالمية.
نقطة النهاية - نقطة النهاية هي موقع يتلقى طلبات الويب. وواجهة برمجة التطبيقات هي مجموعة من نقاط النهاية.
طلب واجهة برمجة التطبيقات - اتصال واجهة برمجة التطبيقات، أو طلب واجهة برمجة التطبيقات، هي رسالة يتم إرسالها إلى نقطة نهاية (الخادم) تطلب من واجهة برمجة التطبيقات توفير خدمة أو معلومات.
استجابة واجهة برمجة التطبيقات - بيانات الاستجابة التي يتم تلقيها من واجهة برمجة تطبيقات لتوفير خدمة أو معلومات.
رموز حالة استجابة HTTP - هذه قائمة برموز حالات استجابة بروتوكول نقل النص التشعبي (HTTP). يتم إصدار رموز الحالة بواسطة الخادم استجابةً لطلب واجهة برمجة تطبيقات تم توجيهه إلى نقطة نهاية، أو الخادم. كل رمز حالة له معنى معين.
ملفات النسخ الرسمية الرئيسية - الملفات التي تشتمل على معرّفات الكيانات القانونية والبيانات المرجعية ذات الصلة التي يتم تحميلها بواسطة جهات إصدار معرّفات الكيانات القانونية إلى GLEIF.
ملفات التحديثات - تحدد ملفات التحديثات فقط معرّفات الكيانات القانونية الصادرة حديثًا و/أو المراجعات التي تمت على البيانات المرجعية لمعرّفات الكيانات القانونية التي تم الإبلاغ عنها سابقًا في ملف النسخة الرسمية الرئيسية المنشور في وقت سابق (منذ ثماني ساعات أو منذ 24 ساعة أو منذ سبعة أيام أو منذ 31 يومًا على الأكثر).
خدمات GLEIF - مجموعة من الخدمات التي تم توفيرها إلى كل من الجمهور وشركائنا لضمان السلامة التشغيلية عبر نظام معرّفات الكيانات القانونية العالمي.
فإذا رغبتم في التعليق على منشور في المدوّنة، يُرجى زيارة خاصيّة المدوّنة على موقع GLEIF الإلكتروني باللغة الإنجليزية لنشر تعليقكم. ويُرجى تعريف أنفسكم بذكر الاسم الأول واسم العائلة. سوف يظهر اسمكم بجانب تعليقكم. لن تُنشر عناوين البريد الإلكتروني. يرجى الملاحظة بأنه من خلال الدخول إلى منتدى المناقشة أو المساهمة فيه فأنتم توافقون على الالتزام بشروط سياسة التدوين لدى GLEIF، ولذا يرجى قراءتها جيدًا.
كريستوف شنايدر هو رئيس تطوير تكنولوجيا المعلومات والعمليات في Global Legal Entity Identifier Foundation (GLEIF). في يونيو 2017، انضم كريستوف إلى المنظمة الدولية للمواصفات والمقاييس (ISO) كقائد مشارك في تدفق عمل المجموعة الفنية الاستشارية Technical Committee 68 FinTech Technical Advisory Group (ISO TC 68 FinTech TAG) الذي يتعامل مع الهوية الرقمية. ويتمتع بخبرة كبيرة في تطوير حلول التكنولوجيا المالية وتنفيذها. وحصل كريستوف على درجة الماجستير في نُظم معلومات الأعمال من جامعة Technische Universität Darmstadt.
