واجهة برمجة تطبيقات التحقق من الهوية الوطنية لجنوب إفريقيا (DHA) (AR)

يتطلب ضم المستخدمين في جنوب إفريقيا التأكد من هويتهم الحقيقية. تتحقق خدمة Didit من بيانات الإدخال مقابل سجل دائرة الشؤون الداخلية (DHA) في جنوب إفريقيا. يثبت المستند أو التفاصيل المكتوبة أن البيانات موجودة فقط — وليس أنها حقيقية أو تخص الشخص الذي أمامك. تحقق خدمة التحقق من الهوية الوطنية لجنوب إفريقيا (DHA) من هذه الفجوة عن طريق التحقق من البيانات مقابل سجل DHA. يشرح هذا الدليل ما تفعله عملية التحقق، والتفاصيل الفنية الدقيقة، وكيفية دمجها في دقائق.

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

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

ماذا تتحقق منه خدمة التحقق من الهوية الوطنية لجنوب إفريقيا (DHA)

تتحقق خدمة Didit من بيانات الإدخال مقابل سجل دائرة الشؤون الداخلية (DHA) في جنوب إفريقيا. تعرض Didit هذه الخدمة من خلال نقطة نهاية واحدة حتى تتمكن من التحقق من البيانات المقدمة مقابل سجل الهوية الحكومي الرسمي للبلاد وتلقي نتيجة منظمة وموحدة — وليس تفريغ سجل خام عليك تحليله بنفسك.

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

لماذا هو مهم

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

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

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

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

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة (string)	نعم	رمز الدولة ISO 3166-1 alpha-3. استخدم ZAF.
services	سلسلة (string)	نعم	معرف الخدمة. استخدم zaf_africa_national_id.
first_name	سلسلة (string)	نعم	الاسم الأول.
last_name	سلسلة (string)	نعم	اسم العائلة.
date_of_birth	سلسلة (string)	نعم	تاريخ الميلاد.
national_id	سلسلة (string)	نعم	معرف الهوية الوطنية.

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_africa_national_id" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111"

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

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_africa_national_id",
      "service_name": "South Africa National ID (DHA)",
      "source_data": {
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "marital_status": "sample_value"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

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

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

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

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

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

يمكنك تشغيل التحقق من الهوية الوطنية لجنوب إفريقيا (DHA) بطريقتين:

1. سير عمل بدون تعليمات برمجية. في Didit Business Console، افتح Workflow Builder، وأضف وحدة التحقق من قاعدة البيانات، واختر جنوب إفريقيا ← التحقق من الهوية الوطنية لجنوب إفريقيا (DHA)، وقم بتنشيطها. يتم توجيه المستخدمين المطابقين تلقائيًا — لا يلزم أي هندسة.
2. واجهة برمجة تطبيقات مباشرة. استدعاء نقطة نهاية /v3/database-validation/ الموضحة أعلاه باستخدام services=zaf_africa_national_id. اقرأ match_type وكتلة validation لكل حقل لتوجيه منطق الموافقة / المراجعة / الرفض الخاص بك.

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

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

ماذا تؤكد عملية التحقق من الهوية الوطنية لجنوب إفريقيا (DHA)؟

تتحقق من البيانات المقدمة مقابل سجل دائرة الشؤون الداخلية (DHA) وتُرجع نتيجة تطابق موحدة، بحيث تعرف ما إذا كانت الهوية الوطنية موجودة في المصدر الموثوق وما هي الحقول التي تطابقت.

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

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

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

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

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

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

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

تحقق من أول هوية وطنية لجنوب إفريقيا اليوم.

• اقرأ مرجع واجهة برمجة التطبيقات: التحقق من الهوية الوطنية لجنوب إفريقيا (DHA)
• اطلع على جميع عمليات التحقق من قاعدة البيانات: تسعير وتغطية التحقق من قاعدة البيانات
• ابدأ البناء: أنشئ حساب Didit مجانيًا — 500 عملية تحقق شهريًا، مجانًا.