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

التغطية

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

المدخلات

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

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

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

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

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

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

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

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يُرجعه السجل. يوثّق المثال المُنشأ لـ nzl_zealand_death_check حاليًا هذا الشكل الموحّد:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • state
  • street

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

تُحتسب رسوم استعلامات New Zealand Death Check (BDM) فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استعلام: $0.27 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب أي رسوم عندما يكون السجل غير متاح، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: عادةً ما يكون زمن الاستجابة عند p95 أقل من ثانيتين.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit، ويختلف توفر مصدر البيانات اللاحق حسب الدولة ومجموعة البيانات.

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

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