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

التغطية

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

المدخلات

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

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

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

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

  • رقم CI الأوروغواياني (من 7 إلى 9 أرقام)
  • يجب أن يحتوي personal_number على أرقام فقط، لذا أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يتراوح طول personal_number بين 7 و9 أحرف.

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

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

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

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

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

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

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