التحقق من الهوية الوطنية الكولومبية (Cédula) عبر API (AR)

تضمين المستخدمين في كولومبيا يعني التأكد من أنهم من يدعون أنهم. تتحقق Didit من بيانات بطاقة الهوية الكولومبية (Cédula de Ciudadanía) من خلال مزود التحقق من الهوية في كولومبيا. يثبت المستند أو التفاصيل المكتوبة أن البيانات موجودة فقط — وليس أنها حقيقية أو تخص الشخص الذي أمامك. يغلق التحقق من Cédula الكولومبية هذه الفجوة عن طريق التحقق من البيانات مقابل السجل الحكومي الرسمي للهوية في البلاد. يشرح هذا الدليل ما يفعله التحقق، والتفاصيل الفنية الدقيقة، وكيفية دمجه في دقائق.

النقاط الرئيسية:

• ماذا يتحقق — يتحقق التحقق من Cédula الكولومبية من الهوية الوطنية مقابل السجل الحكومي الرسمي للهوية في البلاد.
• ماذا تستعيد — match_type مُوحّد بالإضافة إلى نتائج على مستوى الحقل يمكنك توجيهها مباشرة إلى منطق الموافقة / المراجعة / الرفض.
• لماذا هو مهم — يمكن تزوير الوثيقة؛ ولا يمكن تزوير سجل السجل. يؤكد التحقق من الهوية مقابل المصدر الحكومي الموثوق أن حاملها حقيقي وتم التعرف عليه بشكل صحيح.
• كيفية استخدامه — طلب POST واحد إلى نقطة نهاية التحقق من قاعدة البيانات في Didit، أو وحدة سير عمل بدون تعليمات برمجية. 0.20 دولار لكل استعلام حاسم، والنتائج في ثوانٍ.

ماذا يتحقق التحقق من Cédula الكولومبية

يتحقق من بيانات بطاقة الهوية الكولومبية (Cédula de Ciudadanía) من خلال مزود التحقق من الهوية في كولومبيا الخاص بـ Didit. تعرض Didit هذه الخدمة من خلال نقطة نهاية واحدة حتى تتمكن من التحقق من البيانات المقدمة مقابل السجل الحكومي الرسمي للهوية في البلاد وتلقي نتيجة منظمة وموحّدة — وليس تفريغًا خامًا للسجل يجب عليك تحليله بنفسك.

تُرجع الاستجابة الحاسمة source_data المطابقة وكتلة validation لكل حقل، بحيث تحصل محرك المخاطر الخاص بك على حكم واضح ومقروء آليًا.

لماذا هو مهم

يمكن تزوير الوثيقة؛ ولا يمكن تزوير سجل السجل. يؤكد التحقق من الهوية مقابل المصدر الحكومي الموثوق أن حاملها حقيقي وتم التعرف عليه بشكل صحيح.

بالنسبة للشركات المنظمة في كولومبيا — شركات التكنولوجيا المالية، ومنصات العملات المشفرة، والمقرضين، والأسواق، ومشغلي الألعاب — ينتج التحقق من مصدر موثوق سجلًا يمكن الدفاع عنه ومراجعته، يؤكد أن الهوية قد تم تأكيدها من المصدر، وليس مجرد التقاطها من نموذج أو صورة.

التفاصيل الفنية

تعرض Didit هذه الخدمة من خلال نقطة نهاية التحقق من قاعدة البيانات الموحدة. إنها عملية POST واحدة — لا تتطلب SDK.

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة نصية	نعم	رمز البلد ISO 3166-1 alpha-3. استخدم COL.
services	سلسلة نصية	نعم	معرف الخدمة. استخدم col_cedula.
personal_number	سلسلة نصية	نعم	الرقم الشخصي.
first_name	سلسلة نصية	لا	الاسم الأول (فحص اختياري).
last_name	سلسلة نصية	لا	اسم العائلة (فحص اختياري).

مثال على الطلب

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=COL" \
  -F "services=col_cedula" \
  -F "personal_number=1111111"

مثال على الاستجابة (مطابقة حاسمة)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "COL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "col_cedula",
      "service_name": "Colombia - Cédula verification",
      "source_data": {
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

الأداء والفوترة

• وقت الاستجابة: عادة بضع ثوانٍ.
• التكلفة: 0.20 دولار لكل استعلام حاسم. يتم تحصيل الرسوم فقط على النتائج الحاسمة — لا توجد رسوم في حالة توقف المصدر، أو الحقول المفقودة، أو الرفض قبل المصدر.
• الموثوقية: يعمل على بنية Didit التحتية مع هدف وقت تشغيل ربع سنوي بنسبة 99.9%.

حالات الاستخدام

• التكنولوجيا المالية والبنوك الرقمية — تأكيد وجود صاحب حساب حقيقي وقابل للتحقق قبل فتح محفظة أو تقديم ائتمان في كولومبيا.
• العملات المشفرة و Web3 — تلبية متطلبات VASP للانضمام مع إثبات هوية من مصدر موثوق.
• الإقراض — تقليل الاحتيال بالهوية الاصطناعية والاحتيال من الطرف الأول باستخدام بيانات تم التحقق منها من المصدر.
• الأسواق ومنصات العمل الحر — التحقق من المستخدمين مقابل البيانات الموثوقة، وليس مجرد نموذج مُبلغ عنه ذاتيًا.
• الألعاب عبر الإنترنت — تلبية فحوصات الهوية والأهلية للاعبين الكولومبيين بسجل تدقيق.

كيفية الدمج مع Didit

يمكنك تشغيل التحقق من Cédula الكولومبية بطريقتين:

1. سير عمل بدون تعليمات برمجية. في Didit Business Console، افتح Workflow Builder، أضف وحدة Database Validation، حدد Colombia → Colombia Cédula Verification، وقم بتنشيطها. يتم توجيه المستخدمين المطابقين تلقائيًا — لا يتطلب الأمر أي هندسة.
2. واجهة برمجة تطبيقات مباشرة. استدعاء نقطة النهاية /v3/database-validation/ الموضحة أعلاه باستخدام services=col_cedula. اقرأ match_type وكتلة validation لكل حقل لتوجيه منطق الموافقة / المراجعة / الرفض الخاص بك.

يتضمن كل حساب Didit 500 عملية تحقق مجانية شهريًا، حتى تتمكن من اختبار التدفق الكامل من البداية إلى النهاية قبل أن تدفع مقابل أي استعلام واحد.

الأسئلة المتكررة

ماذا يؤكد التحقق من Cédula الكولومبية؟

يتحقق من البيانات المقدمة مقابل السجل الحكومي الرسمي للهوية في البلاد ويعيد نتيجة مطابقة موحدة، لذا ستعرف ما إذا كانت الهوية الوطنية موجودة في المصدر الموثوق وما هي الحقول التي تطابقت.

ماذا يحدث إذا كان المصدر غير متاح مؤقتًا؟

لا يتم تحصيل رسوم منك. تنطبق الفوترة فقط على النتائج الحاسمة — توقف المصدر، والحقول المفقودة، والرفض قبل المصدر مجانية.

ما مدى سرعة التحقق؟

عادةً ما يتم إرجاع التحقق من قاعدة البيانات في غضون بضع ثوانٍ، لذا فهو يتناسب مع تدفق الانضمام في الوقت الفعلي.

هل أحتاج إلى SDK؟

لا. التحقق هو طلب HTTPS POST واحد إلى نقطة نهاية واحدة. يمكنك أيضًا ربطه بسير عمل بدون تعليمات برمجية في Business Console.

هل أنت مستعد للبدء؟

تحقق من أول هوية وطنية كولومبية اليوم.

• اقرأ مرجع API: التحقق من Cédula الكولومبية
• شاهد جميع عمليات التحقق من قاعدة البيانات: تسعير وتغطية التحقق من قاعدة البيانات
• ابدأ البناء: أنشئ حساب Didit مجانيًا — 500 عملية تحقق شهريًا، مجانًا.