الخاص بك الطلب يقرأ المخزن البيانات
عندما تطلب بيانات CPI أو GDP أو العمل أو التجارة، يقرأ Narwhal أحدث إصدار مقبول من قاعدة بياناته. ولا يتصل بالناشر الرسمي أثناء انتظار طلبك.
يفصل هذا زمن استجابة العميل عن عمل استرجاع إصدار جديد والتحقق منه. قد يؤخر موقع مصدر بطيء فحص المصدر، من دون أن يجعل كل طلب عميل ينتظر ذلك الموقع.
يجب أن ينجح الإصدار بأكمله
لا تصبح البيانات الجديدة عامة إلا بعد اجتياز الإصدار الكامل التحقق. ومسار التحديث متعمد البساطة:
- يفحص عامل مجدول المصدر الرسمي.
- يسترجع Narwhal الإصدار ويتحقق من هويته وفترته وحقوله المطلوبة واكتماله.
- تُخزّن الملاحظات المطبّعة وأدلتها المصدرية معاً.
- تصبح النسخة الكاملة من الإصدار هي نسخة العميل الحالية فقط بعد نجاح كل الفحوص المطلوبة.
لا يمحو فشل الفحص البيانات السليمة
قد تتوقف المواقع الرسمية عن الاستجابة. وقد تصل الملفات غير مكتملة، وتتغير الصيغ. وإذا فشل إصدار مرشح في التحقق، يبقي Narwhal آخر منشور مقبول متاحًا. ولا يستبدل القيم بأصفار أو يدمج جزءًا من إصدار فاشل مع الإصدار السابق.
إذا لم يكن لدى Narwhal إصدار يمكنها تقديمه بأمان، تعيد API خطأ 503 موثقًا بدل اختراع نتيجة.
اقرأ التواريخ حرفيًا
يخبرك حقل الفترة بالشهر أو الربع أو السنة التي تغطيها الملاحظة. أما حقل released_on فهو تاريخ النشر الرسمي الذي يورده ذلك الإصدار.
لا تكشف المرحلة التجريبية العامة طابعاً زمنياً لإدخال Narwhal ولا تضمن تأخيراً ثابتاً من نشر المصدر إلى نشر API. تصف هذه التواريخ الملاحظة الاقتصادية وإصدارها الرسمي، لا سرعة استدعاء API لديك.
تحل المراجعات محل القيم السابقة.
تراجع الجهات الاقتصادية الأرقام المنشورة بانتظام. وعندما يجتاز إصدار رسمي منقح الفحوص نفسها، يمكنه استبدال القيمة المخزنة سابقًا لتلك الفترة. ينبغي للتطبيقات التعامل مع البيانات الاقتصادية الرسمية كبيانات منشورة قابلة للتنقيح، لا كسجل أحداث غير قابل للتغيير.
المصادر والمراجع
منشور آخر مراجعة .