الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات هوية المواطن الكولومبي مقابل سجلات Registraduría General de la Nación / ANI الحكومية. تعرض Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، والحصول على نتائج تطابق موحّدة. تنسيق الإدخال: يقبل personal_number رقم الهوية الكولومبية (Cédula) المكوّن من 6 إلى 10 أرقام.

التغطية

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

المدخلات

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

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

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

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

  • رقم الهوية الكولومبية (Cédula) المكوّن من 6 إلى 10 أرقام
  • يجب أن يحتوي personal_number على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول personal_number من 6 إلى 10 أحرف.

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

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

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

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

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

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

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