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

التغطية

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

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

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

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

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

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

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

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

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

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