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

التغطية

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

المدخلات

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

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

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

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

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

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

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

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

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

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

مواصلة القراءة

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