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

التغطية

  • التغطية: ~ 100%
  • الدولة: الدنمارك
  • معرّف الخدمة: dnk_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%
  • السعر: $2.32 لكل استعلام ناجح
لا يحمل كل مستند تقبله هذه الخدمة المعرّف الذي تستعلم به. عندما لا يُستخرج المعرّف من المستند، يُسجَّل الفحص بوصفه غير قابل للتطبيق، ولا يُجرى أي استعلام إلى قاعدة بيانات ولا تُحتسب أي رسوم، وهذا يمثل نسبة كبيرة من المستخدمين الفعليين في بعض الدول. لتغطيتهم، اجمع المعرّف أيضاً من إجابة في الاستبيان، أو من حقل استخراج في Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه بخطوة التحقق من قواعد البيانات.

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

string
افتراضي:"DNK"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: DNK
string
افتراضي:"dnk_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه.مثال: dnk_national_id
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"0101901234"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 0101901234
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}-?\d{4}.
  • بالنسبة إلى خدمات قواعد البيانات القائمة على العنوان، أرسل حقول العنوان المنظمة بدلاً من سلسلة address واحدة متى أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما تتوفر لديك هذه البيانات.
  • address.city هو المدينة أو الضاحية أو المنطقة أو الحي السكني.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العنوان على الأقل عنوان الشارع والرمز البريدي؛ والطلبات التي تُرفض قبل البحث في المصدر لا تُحتسب.

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

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

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

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

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

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

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