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

التغطية

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

المدخلات

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

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

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

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

  • address اختياري لهذه الخدمة. يمكنك إرسال عنوان address نصي كامل واحد، وستقوم Didit بتقسيمه إلى عناصر عنوان منظّمة كلما أمكن ذلك، أو يمكنك إرسال الحقول المنظّمة بشكل صريح.
  • رقم الضمان الاجتماعي الأمريكي أو ITIN - 9 أرقام كاملة (الشرطات اختيارية) أو آخر 4 أرقام فقط
  • يجب أن يطابق ssn النمط (?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4}).
  • بالنسبة إلى ssn، أرسل إما رقم SSN/ITIN المكوّن من 9 أرقام كاملة (الشرطات اختيارية) أو آخر 4 أرقام منه فقط.
  • إضافةً إلى first_name وlast_name المطلوبين، أدرج حقلاً واحداً على الأقل من date_of_birth أو address أو phone أو ssn أو email. يُرفض الطلب الذي يتضمن الاسم فقط قبل الاستعلام لدى المزود (ولا تُفرض عليه رسوم)، ويقدّم date_of_birth نتيجة المطابقة الأكثر موثوقية.
  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المنظّمة بدلاً من سلسلة address واحدة كلما أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويتضمن رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر عنوان إضافي. أرسله فقط عندما يتوفر لديك.
  • address.city هو المدينة أو الضاحية أو المنطقة أو البلدة أو الحي.
  • address.region هو الولاية أو المقاطعة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات المعتمدة على العنوان على الأقل عنوان الشارع والرمز البريدي؛ ولا تُحتسب رسوم على الطلبات المرفوضة قبل الاستعلام عن المصدر.

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

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

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

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

تُفوتَر استعلامات United States Credit Bureau في الولايات المتحدة الأمريكية فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • سعر كل استدعاء: $0.25 دولار أمريكي.
  • الفوترة: لكل استعلام ناجح. لا تُفرض عليك أي رسوم عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: النموذجي للمئين 95 هو أقل من 2 ثانية.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر الذي تعتمد عليه حسب الدولة ومجموعة البيانات.

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

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