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

التغطية

  • التغطية: 50+ سوق
  • الدولة: عالميًا
  • معرّف الخدمة: glb_identity_enrichment
  • نطاق البيانات: الهوية
  • الفئة: IdentityEnrichment

المدخلات

  • المدخلات المطلوبة: لا يوجد
  • المدخلات الاختيارية: email، phone، first_name، last_name، full_name، country_of_residence، vendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: واجهة API المستقلة فقط
  • التغطية: 50+ سوق
  • السعر: $0.20 لكل استعلام ناجح
لا تُقدَّم هذه الخدمة كخطوة من خطوات التحقق من قواعد البيانات داخل سير العمل. هذا القيد يحدد مكان تشغيل الفحص، لا ما يحق لك إرساله. استدعها عبر واجهة API المستقلة، حيث تزوّدها بالمدخلات مباشرة.

معاملات الطلب

string
افتراضي:"GLB"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: GLB
string
افتراضي:"glb_identity_enrichment"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه.مثال: glb_identity_enrichment
موافقة المستخدم النهائي الصريحة على هذه الخدمة.مثال: true
string
افتراضي:"john.doe@example.com"
عنوان البريد الإلكتروني.مثال: john.doe@example.com
string
افتراضي:"+15550101000"
رقم الهاتف بالصيغة الدولية.مثال: +15550101000
string
افتراضي:"John"
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
اسم العائلة المراد التحقق منه.مثال: Doe
string
الاسم القانوني الكامل المراد التحقق منه.مثال: John Doe
string
افتراضي:"US"
بلد الإقامة وفق ISO 3166-1 alpha-2، وهو اختياري. يُستخدم فقط لتركيز البحث عن الهوية.مثال: US
string
افتراضي:"user-1234"
مرجعك الثابت للمستخدم، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، مما يقلل من ضجيج اكتشاف التكرار.مثال: user-1234

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

  • أرسل email أو phone على الأقل، فهما مفتاحا البحث. الطلب الذي لا يحتوي على أيٍّ منهما لا يمكنه تنفيذ استعلام الإثراء، ويُرفض قبل استعلام المصدر، ولا تُحتسب عنه رسوم.
  • أضف الاسم كلما توفر لديك، إذ يقارن المصدر نتيجة البحث به ويحتسب درجة المطابقة. أرسل first_name وlast_name معاً، فهما الحقلان اللذان تقارنهما خريطة validation في الاستجابة. الطلب الذي يرسل full_name وحده يُقيَّم من المصدر، لكنه يعود بخريطة validation فارغة وبقيمة match_type على المستوى الأعلى تساوي null.
  • country_of_residence رمز ISO 3166-1 alpha-2 يُستخدم لتركيز الاستعلام.
  • تُحتسب رسوم كل استعلام مكتمل، حتى لو لم يُعثر على أي شخص (persons_found: 0). الطلب الوحيد المجاني هو الطلب المرفوض قبل تنفيذ الاستعلام، أي الطلب الذي لا يتضمن email ولا phone.

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

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

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

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

تُحتسب استعلامات Global - Identity Enrichment فقط عندما يتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.20 دولار أمريكي.
  • الفوترة: لكل استعلام ناجح. لا يُحتسب عليك أي مبلغ عندما يكون السجل غير متاح، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: عادةً p95 < 2 ثانية.
  • التوفر: 99.9% في الربع السنوي من جهة Didit؛ ويختلف توفر المصدر النهائي حسب الدولة ومجموعة البيانات.

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

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