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

التغطية

  • التغطية: ~ 80%
  • الدولة: إيطاليا
  • معرّف الخدمة: ita_credit_bureau
  • نطاق البيانات: مالية
  • الفئة: CreditBureau

المدخلات

  • المدخلات المطلوبة: first_name، last_name، address.street_1، address.postal_code، tax_number
  • المدخلات الاختيارية: date_of_birth، address.street_2، address.city، address.region، vendor_data
  • الموافقة: غير مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: ~ 80%
  • السعر: $3.25 لكل استعلام ناجح
لا تحمل كل وثيقة تقبلها هذه الخدمة المعرّف الذي تستعلم به. عندما لا يُستخرج المعرّف من الوثيقة، يُسجَّل الفحص بأنه غير قابل للتطبيق، ولا يُستعلم عن أي قاعدة بيانات ولا تُحتسب أي رسوم، وهذا يمثل نسبة كبيرة من المستخدمين الفعليين في بعض الدول. ولتغطية هؤلاء المستخدمين، اجمع المعرّف أيضاً من إجابة في الاستبيان، أو من حقل استخراج في Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات.

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

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

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

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

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

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

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

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

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

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

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