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

التغطية

  • التغطية: > 10%
  • الدولة: نيوزيلندا
  • معرّف الخدمة: nzl_new_zealand_citizenship
  • نطاق البيانات: الهوية
  • الفئة: المواطنة

المدخلات

  • المدخلات المطلوبة: first_name، last_name، date_of_birth
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • توفّرها في سير العمل: متاحة في سير العمل
  • التغطية: > 10%
  • السعر: $1.67 لكل استعلام ناجح

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

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

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

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

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

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

تعتمد الحقول الدقيقة المعروضة في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ nzl_new_zealand_citizenship حالياً البنية الموحّدة التالية:
  • date_of_birth
  • first_name
  • last_name

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

تُحتسب استعلامات DIA - New Zealand Citizenship فقط عندما يتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • سعر الاستدعاء الواحد: $1.67 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب عليك رسوم عندما يتعذّر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل الوصول إلى المصدر.
  • زمن الاستجابة: عادةً p95 < 2 s.
  • التوفّر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفّر المصادر الخارجية حسب الدولة ومجموعة البيانات.

واصل القراءة

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