الانتقال إلى المحتوى الرئيسي
POST
تُرجع أرقام الهواتف والبريد الإلكتروني والعناوين المعروفة المرتبطة بفرد من جنوب أفريقيا. يوفّر Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الموثوق، والحصول على نتائج مطابقة موحّدة.

التغطية

  • التغطية: —
  • الدولة: جنوب أفريقيا
  • معرّف الخدمة: zaf_contactability
  • نطاق البيانات: الاتصالات
  • الفئة: الاتصالات

المدخلات

  • المدخلات المطلوبة: national_id
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: —
  • السعر: $0.35 لكل استعلام ناجح

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

string
افتراضي:"ZAF"
مطلوب
رمز البلد وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ZAF
string
افتراضي:"zaf_contactability"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات هذه بالتحديد.مثال: zaf_contactability
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"SAMPLE-NID-12345"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: SAMPLE-NID-12345
string
افتراضي:"user-1234"
مرجع المستخدم الثابت الخاص بك لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه وتقليل ضوضاء اكتشاف التكرار.مثال: user-1234

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

  • أرسل الحقول المذكورة أعلاه كما التُقطت من المستخدم أو المستند تماماً.
  • يتحقق Didit من الحقول المطلوبة قبل استدعاء قاعدة البيانات. الطلبات المرفوضة قبل الوصول إلى المصدر لا تُحتسب.

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

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

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

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

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

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

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