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

التغطية

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

المدخلات

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

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

string
افتراضي:"NLD"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: NLD
string
افتراضي:"nld_residential"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. يؤدي تثبيت الخدمة إلى قصر الطلب على قاعدة البيانات المحددة هذه بالضبط.مثال: nld_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
رقم الهوية الوطنية لهذه الخدمة.مثال: SAMPLE-NID-12345
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص بوصفه مستخدمًا لديك، مثل معرّف المستخدم الداخلي. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضجيج الناتج عن كشف التكرار.مثال: user-1234

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

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

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُعيده السجل. ويوثّق المثال المُولَّد لـ nld_residential حاليًا البنية الموحّدة التالية:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

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

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

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

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