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

التغطية

  • التغطية: 100%*
  • الدولة: أستراليا
  • معرّف الخدمة: aus_change_of_name_certificate
  • نطاق البيانات: الهوية
  • الفئة: CivilRegistry

المدخلات

  • المدخلات المطلوبة: first_name، وlast_name، وdate_of_birth، وchange_of_name_certificate_number
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • التوفر في سير العمل: متاح في سير العمل مع ربط الحقول
  • التغطية: 100%*
  • السعر: $0.75 لكل استعلام ناجح
في سير العمل، لا يُطبع change_of_name_certificate_number على وثيقة الهوية، لذلك لا توجد خطوة تنتجه بمفردها. اجمعه من إجابة في الاستبيان، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. إلى أن يتم ربطه، يعرض محرر سير العمل هذه الخدمة كمعطّلة ويذكر المدخل الناقص. وعند التشغيل، يعني المدخل الناقص أن الفحص يُتخطى قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن بالإمكان الاستعلام عنها.

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

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

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

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

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

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

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

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

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

مواصلة القراءة

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