الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل سجل وزارة الشؤون الداخلية (DHA) في جنوب أفريقيا. تتيح لك Didit هذه الخدمة عبر POST /v3/database-validation/ للتحقق من البيانات المُرسلة مقابل المصدر الرسمي، واستلام نتائج مطابقة موحّدة.

التغطية

  • التغطية: ~ 100%
  • الدولة: جنوب أفريقيا
  • معرّف الخدمة: zaf_africa_national_id
  • نطاق البيانات: الهوية
  • الفئة: NationalIDRegistry

المدخلات

  • المدخلات المطلوبة: first_name وlast_name وdate_of_birth وnational_id
  • المدخلات الاختيارية: vendor_data
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: ~ 100%
  • السعر: $1.34 لكل استعلام ناجح

معاملات الجسم

string
افتراضي:"ZAF"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ZAF
string
افتراضي:"zaf_africa_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب محصوراً في قاعدة البيانات هذه بالتحديد.مثال: zaf_africa_national_id
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"SAMPLE-NID-12345"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: SAMPLE-NID-12345
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط عمليات التحقق المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

قواعد المدخلات وملاحظات التحقق

  • أرسل الحقول المذكورة أعلاه كما تم التقاطها بالضبط من المستخدم أو المستند.
  • تتحقق Didit من الحقول المطلوبة قبل استدعاء قاعدة البيانات. الطلبات التي تُرفض قبل البحث في المصدر لا تُحتسب تكلفتها.

كيفية الاستدعاء

البيانات المُرجعة

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يُرجعه السجل. يوثّق المثال المُولّد للخدمة zaf_africa_national_id حالياً الشكل الموحّد التالي:
  • first_name
  • identification_number
  • last_name
  • marital_status

الأسعار واتفاقيات مستوى الخدمة

لا تُحتسب استعلامات الهوية الوطنية في جنوب أفريقيا (DHA) إلا عندما تستلم Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $1.34 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب أي تكلفة عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: p95 النموذجي أقل من 2 ثانية.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر الخارجي بحسب الدولة ومجموعة البيانات.

تابع القراءة

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