الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات Cédula الفنزويلية مقابل سجلات السجل الانتخابي لدى CNE. تتيح لك Didit هذه الخدمة عبر POST /v3/database-validation/ للتحقق من البيانات المقدَّمة مقابل المصدر الرسمي والحصول على نتائج مطابقة موحَّدة. صيغة المدخلات: يقبل document_number رقم Cédula الفنزويلية (من 7 إلى 10 أرقام، مع بادئة V أو E اختيارية).

التغطية

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

المدخلات

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

معاملات جسم الطلب

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

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

  • رقم Cédula الفنزويلية (من 7 إلى 10 أرقام، مع بادئة V أو E اختيارية)
  • يجب أن يكون طول document_number بين 7 و12 حرفًا.
  • يجب أن يطابق document_number التعبير [VvEe]?-?\d{7,10}.

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

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

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

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

تُحتسب استعلامات التحقق من Cédula في فنزويلا فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.20 USD.
  • الفوترة: لكل استعلام ناجح. لا تُفرض عليك رسوم عندما يتعذر الوصول إلى السجل، أو عند غياب الحقول المطلوبة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: عادةً أقل من ثانيتين عند المئين 95.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر التابع بحسب الدولة ومجموعة البيانات.

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

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