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

التغطية

  • التغطية: 100%*
  • الدولة: نيوزيلندا
  • معرّف الخدمة: nzl_zealand_drivers_licence
  • نطاق البيانات: المستند
  • الفئة: رخصة القيادة

المدخلات

  • المدخلات المطلوبة: first_name وlast_name وdate_of_birth وdriver_license_number وdriver_license_version
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: 100%*
  • السعر: $0.35 لكل استعلام ناجح

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

string
افتراضي:"NZL"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: NZL
string
افتراضي:"nzl_zealand_drivers_licence"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه.مثال: nzl_zealand_drivers_licence
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"SAMPLE-DL-12345"
مطلوب
رقم رخصة القيادة.مثال: SAMPLE-DL-12345
string
افتراضي:"1"
مطلوب
القيمة driver_license_version التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 1
string
افتراضي:"user-1234"
المرجع الثابت للمستخدم لدى نظامك، مثل معرّف المستخدم الداخلي. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه وتقليل التشويش الناتج عن اكتشاف التكرار.مثال: user-1234

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

  • أرسل الحقول المذكورة أعلاه تماماً كما تم التقاطها من المستخدم أو المستند.
  • يتحقق Didit من الحقول المطلوبة قبل استدعاء قاعدة البيانات. لا تُفرض رسوم على الطلبات التي تُرفض قبل البحث في المصدر.

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

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

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

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

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

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

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