الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات رمز الهوية الفريد الغواتيمالي مقابل سجلات SAT الحكومية. تعرض Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المرسلة مقابل المصدر الرسمي وتلقي نتائج مطابقة موحَّدة. تنسيق الإدخال: يقبل document_number رقم DPI الغواتيمالي (13 رقمًا بالضبط).

التغطية

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

المدخلات

  • الحقول المطلوبة: document_number، date_of_birth
  • الحقول الاختيارية: first_name، last_name، vendor_data
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: 90-95%
  • السعر: $0.20 لكل استعلام ناجح

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

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

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

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

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

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

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

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

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

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

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