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

التغطية

  • التغطية: ~ 85%
  • الدولة: نيوزيلندا
  • معرّف الخدمة: nzl_new_zealand_births
  • نطاق البيانات: الهوية
  • الفئة: BirthRecord

المدخلات

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

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

string
افتراضي:"NZL"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: NZL
string
افتراضي:"nzl_new_zealand_births"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. يُبقي تثبيت الخدمة الطلب مقتصراً على قاعدة البيانات هذه تحديداً.مثال: nzl_new_zealand_births
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: 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_births حالياً الشكل الموحّد التالي:
  • date_of_birth
  • first_name
  • last_name

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

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

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

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