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

التغطية

  • التغطية: > 75%
  • الدولة: المملكة المتحدة
  • معرّف الخدمة: gbr_kingdom_phone_2
  • نطاق البيانات: الاتصالات
  • الفئة: الاتصالات

المدخلات

  • المدخلات المطلوبة: first_name وlast_name وaddress.street_1 وaddress.postal_code وphone
  • المدخلات الاختيارية: date_of_birth وaddress.street_2 وaddress.city وaddress.region وvendor_data
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: > 75%
  • السعر: $1.60 لكل استعلام ناجح

معاملات جسم الطلب

string
افتراضي:"GBR"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: GBR
string
افتراضي:"gbr_kingdom_phone_2"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات المحددة هذه بالضبط.مثال: gbr_kingdom_phone_2
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
object
مطلوب
كائن عنوان سكني مُهيكل. استخدم street_1 وstreet_2 وcity وregion وpostal_code وcountry. ما زالت سلسلة العنوان القديمة الكاملة مقبولة، لكن لا يُنصح بها.مثال: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
افتراضي:"+15550101000"
مطلوب
رقم الهاتف بالصيغة الدولية.مثال: +15550101000
string
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه وتقليل ضجيج كشف التكرار.مثال: user-1234

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

  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المُهيكلة بدلًا من سلسلة address واحدة متى أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما تتوفر لديك هذه البيانات.
  • address.city هي المدينة أو الضاحية أو المنطقة أو المحلّة أو الحي.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين عنوان الشارع والرمز البريدي على الأقل؛ والطلبات المرفوضة قبل البحث في المصدر لا تُفرض عليها رسوم.

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما تُرجعه السجلات. يوضح المثال المُولَّد لـ gbr_kingdom_phone_2 حاليًا البنية الموحّدة التالية:
  • address
  • date_of_birth
  • first_name
  • last_name

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

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

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

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