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

التغطية

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

المدخلات

  • المدخلات المطلوبة: national_id، selfie
  • المدخلات الاختيارية: first_name، last_name، date_of_birth، vendor_data
  • الموافقة: غير مطلوبة
  • توفّر سير العمل: متاح في سير العمل
  • التغطية: ~ 100%
  • السعر: $0.35 لكل استعلام ناجح
ليست كل وثيقة تقبلها هذه الخدمة تحمل المعرّف الذي يُستخدم لإجراء الاستعلام. عندما لا يُستخرج المعرّف من الوثيقة، يُسجَّل الفحص بوصفه غير قابل للتطبيق - لا يُجرى أي استعلام لقاعدة بيانات ولا تُحتسب أي رسوم - وهو ما ينطبق في بعض الدول على نسبة كبيرة من المستخدمين الفعليين. ولتغطيتهم، اجمع المعرّف أيضًا من إجابة في الاستبيانات، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، وقم بربطه في خطوة التحقق من قواعد البيانات.

معاملات جسم الطلب

string
افتراضي:"NGA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: NGA
string
افتراضي:"nga_national_id_facial"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه بالذات.مثال: nga_national_id_facial
string
افتراضي:"11111111111"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 11111111111
file
مطلوب
ملف صورة السيلفي المراد رفعه للتحقق البيومتري من قاعدة البيانات. الصيغ المقبولة: JPEG أو PNG أو WebP.مثال: @./selfie.jpg
string
الاسم الأول المراد التحقق منه.مثال: John
string
اسم العائلة المراد التحقق منه.مثال: Doe
string
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"user-1234"
المرجع الثابت الخاص بك لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل ضجيج اكتشاف التكرار.مثال: user-1234

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

  • يجب أن يطابق first_name النمط [A-Za-zÀ-ÖØ-öø-ÿ .'-]+.
  • يجب أن يحتوي national_id على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول national_id 11 حرفًا بالضبط.

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يعيده السجل. يوثّق المثال المُولَّد لـ nga_national_id_facial حاليًا هذا الشكل الموحّد:
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

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

يتم احتساب رسوم استعلامات Nigeria National ID + Selfie (NIMC) فقط عندما يتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.35 USD.
  • الفوترة: لكل استعلام ناجح. لا يتم احتساب أي رسوم عندما يكون السجل غير متاح، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يتم رفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: زمن p95 المعتاد أقل من 2 s.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر الخارجي حسب الدولة ومجموعة البيانات.

صورة سيلفي ومطابقة الوجه

يُعيد سجل NIMC الكامل لصاحب الرقم الوطني الصالح، لذا فإن معرفة الرقم ليست دليلاً على ملكيته. لذلك يرتبط كل استعلام بصورة سيلفي: تتم مطابقة الوجه مع صورة التسجيل التي يحتفظ بها NIMC لهذا الرقم، ولا يُعاد السجل إلا عندما يعود كلاهما إلى الشخص نفسه.
  • تطابق: يتضمن source_data سجل NIMC وface_match_score. تتم مقارنة الأسماء وتاريخ الميلاد اللذين ترسلهما بالسجل، وتُعرض النتيجة في validation. أرسلها للحصول على حكم بشأن الاسم وتاريخ الميلاد، أو لا ترسلها واقرأ قيم السجل من source_data.
  • شخص مختلف: BIOMETRIC_NO_MATCH. يُعاد face_match_score فقط، ولا تُعاد أي بيانات شخصية.
  • تعذر المطابقة: INCONCLUSIVE عندما لا يحتفظ NIMC بصورة لهذا الرقم، أو عندما لا يمكن العثور على وجه. لا يُعاد أي شيء، ويُرسل الفحص إلى المراجعة.
  • رقم وطني غير معروف: DOCUMENT_NOT_FOUND. يتم احتساب الاستعلام.
في سير العمل تُؤخذ صورة سيلفي من خطوة كشف الحيوية أو مطابقة الوجه، أو من الصورة الموجودة على المستند المرفوع عندما لا يحتوي سير العمل على خطوة للوجه. يُرفض أي طلب بدون صورة سيلفي، أو برقم وطني ليس مكوّناً من 11 رقماً، قبل احتساب أي رسوم.

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

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