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

التغطية

  • التغطية: —
  • الدولة: بنما
  • معرّف الخدمة: pan_cedula_sib_plus
  • نطاق البيانات: الهوية
  • الفئة: سجل الهوية الوطنية

المدخلات

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

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

string
افتراضي:"PAN"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: PAN
string
افتراضي:"pan_cedula_sib_plus"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه.مثال: pan_cedula_sib_plus
string
افتراضي:"8-123-456"
مطلوب
رقم الهوية الشخصية الخاص بالدولة.مثال: 8-123-456
file
مطلوب
ملف صورة السيلفي المراد رفعه للتحقق البيومتري من قاعدة البيانات. الصيغ المقبولة: JPEG أو PNG أو WebP.مثال: @./selfie.jpg
string
افتراضي:"user-1234"
مرجعك الثابت للمستخدم، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل ضوضاء كشف التكرار.مثال: user-1234

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

  • Cédula البنمية (الحد الأدنى 5 محارف)
  • يجب أن يتراوح طول personal_number بين 5 و20 محرفاً.
  • يجب أن يستخدم personal_number أحرفاً كبيرة.
  • يجب أن يطابق personal_number النمط (?:\d{1,2}(?:-?(?:AV|PI))?|PE|E|N)[\d-]*.

طريقة الاستدعاء

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُرجعه السجل. يوثّق المثال المُولّد للخدمة pan_cedula_sib_plus حالياً هذا الشكل الموحّد:
  • date_of_birth
  • expiration_date
  • full_name
  • gender
  • identification_number
  • issue_date
  • last_name
  • place_of_birth
  • signature

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

تُحتسب استعلامات بنما - Cédula مع مطابقة الوجه البيومترية (SIB Plus، المستوى المتقدم) فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $1.50 USD.
  • الفوترة: لكل استعلام ناجح. لا يُحتسب عليك أي رسوم عندما يتعذّر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: النموذجي عند p95 هو أقل من 2 ثانية.
  • التوافر: 99.9% لكل ربع سنة من جهة Didit؛ ويتفاوت توافر المصدر التابع حسب الدولة ومجموعة البيانات.

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

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