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

التغطية

  • التغطية: —
  • الدولة: Colombia
  • معرّف الخدمة: col_migracion
  • نطاق البيانات: الهوية
  • الفئة: تصريح الإقامة

المدخلات

  • المدخلات المطلوبة: personal_number، date_of_birth، nationality
  • المدخلات الاختيارية: first_name، last_name، vendor_data
  • الموافقة: غير مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: —
  • السعر: ‎$1.20 لكل استعلام ناجح

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

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

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

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

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

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

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

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

Colombia - تُحتسب الاستعلامات عن وضع الأجانب لدى Migración Colombia فقط عندما تستلم Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: ‎$1.20 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب عليك رسوم عندما يكون السجل غير متاح، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: عادةً، يكون زمن الاستجابة عند النسبة المئوية 95 (p95) أقل من ثانيتين.
  • التوفر: 99.9% لكل ربع سنة من جانب Didit؛ ويختلف توفر المصدر النهائي حسب الدولة ومجموعة البيانات.

واصل القراءة

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