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