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

التغطية

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

المدخلات

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

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

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

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

  • يجب أن يطابق national_id النمط \d{8,9}.

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

البيانات المُعادة

تختلف الحقول الظاهرة في source_data باختلاف ما يُرجعه السجل. يوثّق المثال المُنشأ لـ ken_national_id حاليًا هذا الشكل الموحّد:
  • date_of_birth
  • first_name
  • gender
  • identification_number
  • last_name

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

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

تابع القراءة

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