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

التغطية

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

المدخلات

  • المدخلات المطلوبة: document_number، selfie
  • المدخلات الاختيارية: first_name، last_name، date_of_birth، vendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: ~ 100%
  • السعر: $0.40 لكل استعلام ناجح

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

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

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

  • رقم DPI الغواتيمالي (13 رقمًا بالضبط)
  • يجب أن يحتوي document_number على أرقام فقط؛ أزِل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول document_number 13 حرفًا بالضبط.
  • يجب أن يطابق document_number النمط \d{13}.

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

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

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

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

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

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

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