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

التغطية

  • التغطية: ~ 100%
  • الدولة: فنلندا
  • معرّف الخدمة: fin_national_id
  • نطاق البيانات: الهوية
  • الفئة: NationalIDRegistry

المدخلات

  • المدخلات المطلوبة: first_name، last_name، date_of_birth، national_id
  • المدخلات الاختيارية: address.street_1، address.street_2، address.city، address.region، address.postal_code، vendor_data
  • الموافقة: مطلوبة
  • إتاحة سير العمل: متاحة في سير العمل
  • التغطية: ~ 100%
  • السعر: $3.50 لكل استعلام ناجح
لا تحمل كل وثيقة تقبلها هذه الخدمة المعرّف الذي تُجرى الاستعلامات به. عندما لا يُستخرج المعرّف من الوثيقة، يُسجَّل الفحص بوصفه غير قابل للتطبيق: لا يتم الاستعلام عن أي قاعدة بيانات ولا يتم تحصيل أي رسوم منك. وفي بعض الدول يشكّل هذا النوع من الحالات نسبة كبيرة من المستخدمين الفعليين. لتغطيتهم، اجمع المعرّف أيضاً من إجابة في أحد الاستبيانات، أو من حقل استخراج في Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه بخطوة التحقق من قواعد البيانات.

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

string
افتراضي:"FIN"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: FIN
string
افتراضي:"fin_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه.مثال: fin_national_id
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"010190-123A"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 010190-123A
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 كاملة واحدة، وستقوم Didit بتقسيمها إلى عناصر عنوان منظَّمة متى أمكن ذلك، أو يمكنك إرسال الحقول المنظَّمة بشكل صريح.
  • يجب أن يتطابق national_id مع (?:\d{6}[-+A]\d{3}[0-9A-Z]|\d{6}\d{3}[0-9A-Z]).
  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المنظَّمة بدلاً من سلسلة address واحدة متى أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما يتوفر لديك.
  • address.city هو المدينة أو الضاحية أو الحي أو المنطقة المحلية أو الجوار.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات المعتمدة على العنوان على الأقل عنوان الشارع والرمز البريدي. لا يتم تحصيل رسوم عن الطلبات التي تُرفض قبل البحث في المصدر.

كيفية الاستدعاء

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

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

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

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

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

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