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

التغطية

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

المدخلات

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

معاملات نص الطلب

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

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

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

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

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

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

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

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

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

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