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

التغطية

  • التغطية: ~ 75%
  • الدولة: إسبانيا
  • معرّف الخدمة: esp_dni
  • مجال البيانات: الهوية
  • الفئة: NationalIDRegistry

المدخلات

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

معاملات جسم الطلب

string
افتراضي:"ESP"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ESP
string
افتراضي:"esp_dni"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه تحديدًا.مثال: esp_dni
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
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
رقم الهوية الوطنية لهذه الخدمة.مثال: SAMPLE-NID-12345
string
رقم الهاتف بالتنسيق الدولي.مثال: +15550101000
string
افتراضي:"user-1234"
مرجع المستخدم الثابت لديك لهذا الشخص، مثل معرّف المستخدم الداخلي. تستخدمه Didit لربط عمليات التحقق المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

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

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

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

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

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

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

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

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

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