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

التغطية

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

المدخلات

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

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

string
افتراضي:"NGA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لهذه الخدمة من قواعد البيانات.مثال: NGA
string
افتراضي:"nga_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه تحديداً.مثال: nga_national_id
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"11111111111"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 11111111111
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 حالياً هذا الشكل الموحّد:
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

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

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

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

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