الانتقال إلى المحتوى الرئيسي
POST
تتحقق هذه الخدمة من بيانات Cédula الباراغوانية مقابل سجلات Registro del Estado Civil الحكومية. تتيح Didit هذه الخدمة عبر POST /v3/database-validation/ للتحقق من البيانات المُرسلة مقابل المصدر الرسمي وتلقي نتائج تطابق موحّدة. صيغة الإدخال: يقبل document_number رقم CI باراغواي (6-10 أرقام).

التغطية

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

المدخلات

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

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

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

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

  • CI باراغواي (6-10 أرقام)
  • يجب أن يحتوي document_number على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يتكون document_number من 6 إلى 10 أحرف.

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

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

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

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

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

تابع القراءة

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