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

التغطية

  • التغطية: —
  • الدولة: فنلندا
  • معرّف الخدمة: fin_consumer_2
  • نطاق البيانات: العنوان
  • الفئة: سكني

المدخلات

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

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

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

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

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

كيفية استدعائها

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

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

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

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

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

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