الانتقال إلى المحتوى الرئيسي
POST
يتحقق من صور بصمات الأصابع المقدَّمة مقابل سجل بصمات الأصابع لدى Department of Home Affairs. تتيح Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المرسلة مقابل المصدر الرسمي، والحصول على نتائج مطابقة موحَّدة.

التغطية

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

المدخلات

  • المدخلات المطلوبة: national_id وright_thumb وleft_thumb
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: واجهة API المستقلة فقط
  • التغطية: -
  • السعر: $1.28 دولار أمريكي لكل استعلام ناجح
تطلب هذه الخدمة الحقلين right_thumb وleft_thumb، وهما قيمتان لا تنتجهما أي خطوة في سير العمل، لذلك تتوفر فقط عبر واجهة API المستقلة، حيث تزوّدها بالقيم مباشرةً.

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

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

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

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

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

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

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

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

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

مواصلة القراءة

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