مستويات الخدمة

هذه هي الأهداف التي نشغّل واجهة الإنتاج البرمجية وفقًا لها، مقيسةً من جانبنا، لكل شهر تقويمي. وقد تمنح عقود منتجات البيانات أرصدة تعويضية مقابلها؛ وينص العقد على ذلك حيث يمنحها.

لا يُحتسب ضمن الأهداف:

• الإجابات التي يتسبب فيها الطلب نفسه: 4xx، بما فيها 429 لحدود المعدل والحصص.
• إجابات 503 التي تحمل رمز شريك (escrow_unavailable، credit_unavailable، ...) أثناء تعطل ذلك الشريك. ونخبرك بأي شريك تعطل ومتى يعود.
• فشل نقطة استقبال خطاف الويب لديك أو بطء إجابتها. وتتبع إعادة المحاولة جدول خطافات الويب.
• البيئة التجريبية، غير المتاحة بعد؛ وعندما تعمل، تُشغَّل على أساس بذل أفضل جهد ممكن.
• الصيانة المُعلَن عنها قبل 7 أيام على الأقل، بما لا يتجاوز 4 ساعات في الشهر، خارج الفترة من 06:00 إلى 22:00 بتوقيت تركيا.

عندما يحدث خلل

• تُنشر الحوادث التي تؤثر في الواجهة البرمجية على صفحة الحالة فور وقوعها، مع تحديثات كل ساعة على الأقل حتى تُحَل.
• يُبلَّغ عملاء منتجات البيانات مباشرةً، عبر جهات الاتصال المذكورة في عقودهم.
• يصدر تقرير ما بعد الحادث خلال 5 أيام عمل لكل حادث استهلك أكثر من ربع ميزانية الأخطاء الشهرية (نحو 11 دقيقة من الانقطاع الكامل).

من جانبك

أعِد محاولة 5xx و429 مع تباعد متزايد وتفاوت عشوائي بين المحاولات. واجعل معالجات خطافات الويب سريعة وآمنة عند التكرار (idempotent). وسجّل X-Request-Id: فبه نستطيع تتبع أي طلب تسأل عنه.