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

التغطية

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

المدخلات

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

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

string
افتراضي:"ITA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ITA
string
افتراضي:"ita_residential"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه بالضبط.مثال: ita_residential
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة 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.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما تتوفر لديك هذه المعلومة.
  • address.city هو المدينة أو الضاحية أو الحي أو المنطقة المحلية.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين على الأقل عنوان الشارع والرمز البريدي. لا تُفرض رسوم على الطلبات التي تُرفض قبل البحث في المصدر.

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

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

تعتمد الحقول المحددة المعروضة في source_data على ما يُعيده السجل. يوثّق المثال المُولَّد لـ ita_residential حالياً هذا الشكل الموحّد:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • street

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

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

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

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