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

التغطية

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

المدخلات

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

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

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

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

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

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

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