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

التغطية

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

المدخلات

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

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

string
افتراضي:"FRA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: FRA
string
افتراضي:"fra_phone"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه تحديداً.مثال: fra_phone
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"+15550101000"
مطلوب
رقم الهاتف بالتنسيق الدولي.مثال: +15550101000
string
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
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
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

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

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

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

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

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

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

تُحتسب استعلامات الهاتف في فرنسا فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $1.12 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب الرسوم عندما تكون الجهة المصدرة غير متاحة، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: زمن الاستجابة المعتاد عند النسبة المئوية 95 أقل من ثانيتين.
  • التوفر: 99.9% لكل ربع سنة من جانب Didit، ويختلف توفر المصدر التابع حسب الدولة ومجموعة البيانات.

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

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