الانتقال إلى المحتوى الرئيسي
POST
خدمة SERPRO Datavalid v4 pf-facial-qrcode تفكّ ترميز رمز QR المطبوع على رخص القيادة البرازيلية CNH (الورقية أو الرقمية، الصادرة منذ مايو 2017)، وتتحقق من CPF والاسم وتاريخ الميلاد مقابل Receita Federal، وتطابق صورة السيلفي الحية مع صورة CNH المخزنة لدى Senatran. تعرض Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، واستلام نتائج مطابقة موحّدة. صيغة المدخل: يقبل tax_number رقم CPF البرازيلي (11 رقمًا بالضبط).

التغطية

  • التغطية: -
  • الدولة: البرازيل
  • معرّف الخدمة: bra_cnh_facial_qrcode
  • نطاق البيانات: بيومتري
  • الفئة: DriverLicence

المدخلات

  • الحقول المطلوبة: tax_number، selfie، cnh_qr_code_image
  • الحقول الاختيارية: first_name، last_name، date_of_birth، vendor_data
  • الموافقة: مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: -
  • السعر: $0.62 لكل استعلام ناجح

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

string
افتراضي:"BRA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: BRA
string
افتراضي:"bra_cnh_facial_qrcode"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه بالضبط.مثال: bra_cnh_facial_qrcode
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"11111111111"
مطلوب
رقم التعريف الضريبي أو المالي.مثال: 11111111111
file
مطلوب
ملف صورة السيلفي المراد رفعه للتحقق البيومتري من قاعدة البيانات. الصيغ المقبولة: JPEG أو PNG أو WebP.مثال: @./selfie.jpg
string
مطلوب
قيمة cnh_qr_code_image المطلوبة من خدمة قاعدة البيانات هذه.مثال: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB
string
الاسم الأول المراد التحقق منه.مثال: John
string
اسم العائلة المراد التحقق منه.مثال: Doe
string
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"user-1234"
مرجعك الثابت للمستخدم، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط عمليات التحقق المستقلة بالمستخدم النهائي نفسه وتقليل ضوضاء كشف التكرار.مثال: user-1234

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

  • رقم CPF البرازيلي (11 رقمًا بالضبط)
  • يجب أن يحتوي tax_number على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول tax_number 11 حرفًا بالضبط.

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

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

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

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

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

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

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