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

التغطية

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

المدخلات

  • المدخلات المطلوبة: first_name، last_name، passport_number، passport_issue_country
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: 100%*
  • السعر: $0.75 لكل استعلام ناجح

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

string
افتراضي:"AUS"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: AUS
string
افتراضي:"aus_travel_document"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات هذه بالتحديد.مثال: aus_travel_document
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"SAMPLE-PASS-12345"
مطلوب
رقم جواز السفر.مثال: SAMPLE-PASS-12345
string
افتراضي:"USA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 للدولة التي أصدرت جواز السفر.مثال: USA
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

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

  • رمز الدولة وفق ISO 3166-1 alpha-3
  • يجب أن يستخدم passport_issue_country أحرفاً كبيرة.
  • يجب أن يطابق passport_issue_country النمط [A-Za-z]{3}.

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

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

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

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

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

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

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