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

التغطية

  • التغطية: —
  • الدولة: جنوب أفريقيا
  • معرّف الخدمة: zaf_vehicle_ownership
  • مجال البيانات: حكومي
  • الفئة: أخرى

المدخلات

  • المدخلات المطلوبة: national_id، وvehicle_register_number، وvehicle_licence_plate، وvin
  • المدخلات الاختيارية: vendor_data
  • الموافقة: غير مطلوبة
  • توفر سير العمل: متاح في سير العمل مع ربط الحقول
  • التغطية: —
  • السعر: $3.36 لكل استعلام ناجح
في سير العمل، لا تُطبع الحقول vehicle_register_number وvehicle_licence_plate وvin على وثيقة الهوية، لذلك لا تنتجها أي خطوة بمفردها. اجمعها من إجابة في الاستبيان، أو من حقل استخراج Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربط كل حقل منها في خطوة التحقق من قواعد البيانات. وإلى أن تُربط، يعرض محرر سير العمل هذه الخدمة معطّلة ويذكر المدخل المفقود. وعند التشغيل، إذا كان هناك مدخل مفقود، فسيتم تخطي الفحص قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن بالإمكان الاستعلام عنها.

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

string
افتراضي:"ZAF"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ZAF
string
افتراضي:"zaf_vehicle_ownership"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه بالذات.مثال: zaf_vehicle_ownership
string
افتراضي:"SAMPLE-NID-12345"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: SAMPLE-NID-12345
string
افتراضي:"VRN123456"
مطلوب
قيمة vehicle_register_number التي تتطلبها خدمة قاعدة البيانات هذه.مثال: VRN123456
string
افتراضي:"ABC123GP"
مطلوب
قيمة vehicle_licence_plate التي تتطلبها خدمة قاعدة البيانات هذه.مثال: ABC123GP
string
افتراضي:"1HGCM82633A004352"
مطلوب
قيمة vin التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 1HGCM82633A004352
string
افتراضي:"user-1234"
مرجع المستخدم الثابت الخاص بك لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوص المستقلة بالمستخدم النهائي نفسه وتقليل ضوضاء اكتشاف التكرار.مثال: user-1234

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

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

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

البيانات المُعادة

تعتمد الحقول الدقيقة المعروضة في source_data على ما يُرجعه السجل. يوثّق المثال المُنشأ لـ zaf_vehicle_ownership حاليًا هذا الشكل الموحّد:
  • identification_number

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

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

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

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