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

التغطية

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

المدخلات

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

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

string
افتراضي:"DEU"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: DEU
string
افتراضي:"deu_credit_bureau"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات المحددة هذه.مثال: deu_credit_bureau
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
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 على ما يعيده السجل. يوثّق المثال المُولَّد لـ deu_credit_bureau حاليًا البنية الموحدة التالية:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • street

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

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

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

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