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

التغطية

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

المدخلات

  • المدخلات المطلوبة: 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
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: ~ 85%
  • السعر: $0.20 لكل استعلام ناجح

معاملات نص الطلب

string
افتراضي:"USA"
مطلوب
رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: USA
string
افتراضي:"usa_states_financial_services"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات هذه تحديدًا.مثال: usa_states_financial_services
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، أرسل إما رقم الضمان الاجتماعي أو ITIN كاملًا من 9 أرقام (الشرطات اختيارية)، أو آخر 4 أرقام منه فقط.
  • تتطلب هذه الخدمة first_name وlast_name وdate_of_birth، وهذا يحقق الحد الأدنى الذي يشترطه المصدر وهو اسم مع حقل هوية إضافي واحد. الحقول الاختيارية (ssn وaddress وphone وemail) تعزز المطابقة أكثر.
  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المنظّمة بدلًا من سلسلة address واحدة كلما أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عند توفره لديك.
  • address.city هو المدينة أو الضاحية أو المنطقة أو الحي أو الجوار.
  • address.region هو الولاية أو المقاطعة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين على الأقل عنوان الشارع والرمز البريدي. لا تُحتسب الطلبات التي تُرفض قبل البحث في المصدر.

طريقة الاستدعاء

البيانات المُعادة

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

الأسعار واتفاقيات SLA

تُحتسب استعلامات United States of America - United States Financial Services فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.20 USD.
  • الفوترة: لكل استعلام ناجح. لا يُحتسب أي مبلغ عندما يتعذّر الوصول إلى السجل، أو عند غياب الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: المعتاد عند p95 أقل من 2 ثانية.
  • التوفّر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفّر المصادر التابعة حسب الدولة ومجموعة البيانات.

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

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