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

التغطية

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

المدخلات

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

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

string
افتراضي:"AUS"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: AUS
string
افتراضي:"aus_credit_bureau"
مطلوب
مصفوفة تحتوي على معرّف الخدمة هذا. يؤدي تثبيت الخدمة إلى قصر الطلب على قاعدة البيانات المحددة بالضبط.مثال: aus_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
رقم الهاتف بالصيغة الدولية.مثال: +15550101000
string
عنوان البريد الإلكتروني.مثال: john.doe@example.com
string
افتراضي:"user-1234"
معرّفك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه وتقليل الضوضاء الناتجة عن اكتشاف التكرار.مثال: user-1234

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

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

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

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

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

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

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

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

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