الانتقال إلى المحتوى الرئيسي
GET
curl

نظرة عامة

تُرجع هذه النقطة حالة كل خدمة من خدمات Didit، والحالة العامة، والحوادث الجارية والمحلولة خلال آخر 7 أيام. الـ endpoint عام: لا ترسل رأس المصادقة. لا تحتوي الاستجابة على أي بيانات للمؤسسة، وهي نفسها لكل مستدعٍ.

متى تستخدمها

  • أداة عرض الحالة: اعرض لمستخدميك أو لفريق الدعم لديك ما إذا كانت خدمة Didit متدهورة الآن.
  • فحص حالة تشغيل التكامل: قبل أن تُرجع البطء أو فشل الفحوصات إلى كودك، تحقّق مما إذا كانت Didit تُبلغ عن حادثة في الخدمة التي تستدعيها.
  • سجل الحوادث: اعرض ما حدث خلال آخر 7 أيام ومدة كل حادثة.
لمجرد التحقق من أن الواجهة قابلة للوصول، استخدم فحص الصحة بدلاً من ذلك.

الاستعلام الدوري

تُخزَّن الاستجابات مؤقتًا لمدة 30 ثانية، لذا لا تستعلم أكثر من مرة كل 30 ثانية. يخبرك updated_at بالوقت الذي أنشأت فيه Didit الاستجابة التي تلقيتها. ينطبق أيضاً حد لطلبات GET يبلغ 600 طلب في الدقيقة لكل عنوان IP.

الخدمات

يسرد services كل خدمة، سواء كانت لديها حادثة أم لا. طابِق باستخدام key: فالحقل name اسم عرض بالإنجليزية وقد يتغير. تكون status لكل خدمة إما operational أو degraded أو down. تكون الحالة operational عندما لا تكون لدى الخدمة حادثة جارية، وإلا فهي أسوأ حالة بين حوادثها الجارية. أما status على المستوى الأعلى فهي أسوأ حالة بين جميع الخدمات.

الحوادث

يسرد incidents كل حادثة جارية والحوادث المحلولة خلال آخر 7 أيام، مرتبةً من الأحدث started_at إلى الأقدم. تُسرد 50 حادثة محلولة كحد أقصى.
  • state إما degraded أو down. تحتفظ الحادثة المحلولة بآخر حالة كانت عليها.
  • status تكون ongoing حتى تتعافى الخدمة، ثم تصبح resolved.
  • تكون resolved_at وduration_minutes بقيمة null ما دامت الحادثة جارية.
  • يحدد affected وcountry_name الدولة أو السجل المتأثر، مثل Brazil (CPF) وBrazil. تكونان فارغتين عندما لا ترتبط الحادثة بدولة أو سجل.
  • title وbody باللغة الإنجليزية. لعرض الحادثة بلغة أخرى، أنشئ نصك الخاص من service وstate وcountry_name.

مثال على الاستجابة

ذات صلة

  • فحص الصحة: فحص حيوية عام لا يحتاج هو أيضاً إلى رأس المصادقة.
  • webhook التنبيهات: استلم alert.service.degraded وalert.service.recovered مرسلةً إلى الـ endpoint الخاص بك، للخدمات التي تستخدمها مؤسستك.
  • حد المعدل

الاستجابة

حالة الخدمة الحالية.

حالة الخدمة العامة: حالة كل خدمة من خدمات Didit، والحالة العامة، والحوادث الجارية أو التي تم حلها خلال آخر 7 أيام.

status
enum<string>
مطلوب

أسوأ حالة لأي خدمة في الوقت الحالي، وتُحدد بناءً على الحوادث الجارية فقط.

الخيارات المتاحة:
operational,
degraded,
down
مثال:

"degraded"

updated_at
string<date-time>
مطلوب

وقت إنشاء Didit لهذه الاستجابة (ISO 8601، بتوقيت UTC). يتم تخزين الاستجابات مؤقتاً لمدة 30 ثانية، لذا قد يصل عمرها إلى 30 ثانية.

مثال:

"2026-10-13T09:41:07.512345Z"

services
object[]
مطلوب

إدخال واحد لكل خدمة، مع إدراج كل خدمة دائماً.

incidents
object[]
مطلوب

الأحدث بحسب started_at أولاً. كل حادث مستمر، بالإضافة إلى الحوادث التي تم حلها خلال آخر 7 أيام (بحد أقصى 50 حادثاً تم حله). فارغ إذا لم يحدث شيء خلال تلك الفترة.

آخر تعديل في ٧ نوفمبر ٢٠٢٦