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

التغطية

  • التغطية: —
  • الدولة: جنوب أفريقيا
  • معرّف الخدمة: zaf_dha_photo
  • نطاق البيانات: بيومتري
  • الفئة: حكومية

المدخلات

  • المدخلات المطلوبة: national_id
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: —
  • السعر: $1.34 لكل استعلام ناجح

معاملات الطلب

string
افتراضي:"ZAF"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ZAF
string
افتراضي:"zaf_dha_photo"
مطلوب
مصفوفة تحتوي على معرّف الخدمة هذا. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه.مثال: zaf_dha_photo
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"SAMPLE-NID-12345"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: SAMPLE-NID-12345
string
افتراضي:"user-1234"
المرجع الثابت للمستخدم لدى نظامك، مثل معرّف المستخدم الداخلي. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، مما يقلل الإنذارات الخاطئة الناتجة عن اكتشاف التكرار.مثال: user-1234

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

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

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

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

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ zaf_dha_photo حاليًا هذا الشكل الموحّد:
  • birth_place_country_code
  • deceased
  • first_name
  • id_blocked
  • identification_number
  • last_name
  • marital_status
  • on_hanis_biometric_register
  • on_national_population_register
  • photo_base64
  • smart_card_issued
  • transaction_number

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

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

متابعة القراءة

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