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

التغطية

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

المدخلات

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

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

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

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

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

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

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