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

التغطية

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

المدخلات

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

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

string
افتراضي:"USA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: USA
string
افتراضي:"usa_states_phone_2"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه تحديداً.مثال: usa_states_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
قيمة ssn التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 123456789
string
افتراضي:"user-1234"
معرّفك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء الناتجة عن اكتشاف التكرار.مثال: user-1234

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

  • رقم الضمان الاجتماعي الأمريكي (9 أرقام، مع شرطات اختيارية)
  • يجب أن تطابق ssn النمط (?:\d{9}|\d{3}-\d{2}-\d{4}).
  • بالنسبة إلى ssn، أرسل رقم SSN أو ITIN كاملاً من 9 أرقام (الشرطات اختيارية). وعلى عكس فحوصات مكتب الائتمان الأمريكي والخدمات المالية، لا تقبل هذه الخدمة صيغة الأرقام الأربعة الأخيرة فقط.
  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المنظّمة بدلاً من سلسلة address واحدة كلما أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر عنوان إضافي. أرسله فقط عندما يتوفر لديك.
  • address.city هو المدينة أو الضاحية أو المقاطعة أو المنطقة المحلية أو الحي.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين عنوان الشارع والرمز البريدي على الأقل. والطلبات المرفوضة قبل البحث في المصدر لا تُفرض عليها رسوم.

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُرجعه السجل. يوثّق المثال المُنشأ تلقائياً لـ usa_states_phone_2 الشكل الموحّد التالي حالياً:
  • address
  • date_of_birth
  • first_name
  • last_name

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

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

مواصلة القراءة

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