الانتقال إلى المحتوى الرئيسي
POST
يتحقق من رقم DNI الأرجنتيني مقابل السجل المدني الرسمي RENAPER، مع مطابقة الوجه بيومتريًا للصورة المحفوظة لديه. تغطية 100% من السكان. تتيح لك Didit الوصول إلى هذه الخدمة عبر POST /v3/database-validation/ لمقارنة البيانات المقدَّمة بالمصدر الموثوق، والحصول على نتائج مطابقة موحّدة. صيغة الإدخال: يقبل الحقل document_number رقم DNI الأرجنتيني (7-8 أرقام، مع بادئة اختيارية M أو F).

التغطية

  • التغطية: 100%
  • الدولة: الأرجنتين
  • معرّف الخدمة: arg_renaper
  • نطاق البيانات: الهوية
  • الفئة: NationalIDRegistry
RENAPER هي السجل الذي يصدر كل بطاقات DNI الأرجنتينية، لذلك فإن كل رقم DNI مسجل لديها، بما في ذلك أرقام DNI الصادرة للمقيمين الأجانب. تقارن مطابقة الوجه صورة السيلفي بالصورة التي يحتفظ بها RENAPER لرقم DNI هذا.

المدخلات

  • الحقول المطلوبة: document_number، selfie، gender
  • الحقول الاختيارية: first_name، last_name، date_of_birth، vendor_data
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: 100%
  • السعر: $0.20 لكل استعلام ناجح

معلمات الجسم

string
افتراضي:"ARG"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ARG
string
افتراضي:"arg_renaper"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات هذه بالتحديد.مثال: arg_renaper
string
افتراضي:"11111111"
مطلوب
رقم المستند المستخرج من المستند أو المقدَّم من المستخدم.مثال: 11111111
file
مطلوب
ملف صورة السيلفي المراد رفعه للتحقق البيومتري من قاعدة البيانات. الصيغ المقبولة: JPEG أو PNG أو WebP.مثال: @./selfie.jpg
string
افتراضي:"M"
مطلوب
قيمة الجنس، عندما تطلبها قاعدة البيانات.القيم المسموحة: M (ذكر)، F (أنثى)، X (آخر أو غير معروف).مثال: M
string
الاسم الأول المراد التحقق منه.مثال: John
string
اسم العائلة المراد التحقق منه.مثال: Doe
string
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط عمليات التحقق المستقلة بالمستخدم النهائي نفسه، وتقليل ضجيج اكتشاف التكرار.مثال: user-1234

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

  • رقم DNI الأرجنتيني (7-8 أرقام، مع بادئة اختيارية M أو F)
  • يجب أن يكون طول document_number بين 7 و9 أحرف.
  • يجب أن يطابق document_number النمط [MFmf]?\d{7,8}.

طريقة الاستدعاء

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

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يُرجعه السجل. يوثّق المثال المُنشأ لـ arg_renaper حالياً البنية الموحّدة التالية:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

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

الأرجنتين - استعلامات التحقق من DNI (RENAPER) تُحتسب فقط عندما يتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.20 دولار أمريكي.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب رسوم عندما يكون السجل غير قابل للوصول، أو عند نقص الحقول المطلوبة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: عادةً p95 < 2 s.
  • التوفر: 99.9% في كل ربع سنة من جهة Didit؛ ويختلف توفر مصدر البيانات الخارجي بحسب الدولة ومجموعة البيانات.

درجة مطابقة الوجه

face_match_score هي درجة التشابه التي يحسبها RENAPER بين صورة السيلفي والصورة المسجلة لدى الجهة للرقم DNI، وتُرسل كعدد صحيح من 0 إلى 100 داخل سلسلة نصية، مثل "92". وهي ليست احتمالاً بين 0 و1. يعيد الفحص BIOMETRIC_NO_MATCH عندما يُبلغ RENAPER بأن الوجه غير متطابق، أو عندما تقل الدرجة عن 50. عند 50 أو أكثر يُقبل الوجه، وتُقارن بعد ذلك الاسم المسجل وتاريخ الميلاد المسجل بالبيانات التي أرسلتها. قد تكون الصورة المسجلة قديمة بعدة سنوات، لذلك قد تسجّل مستخدماً حقيقياً درجة منخفضة بعد تغيّر كبير في مظهره. فكّر في إرسال BIOMETRIC_NO_MATCH إلى مراجعة يدوية بدلاً من رفضه مباشرة، مع الاستفادة من الإجراءات الخاصة بالمطابقة الجزئية وعدم المطابقة.

عندما لا يستجيب RENAPER

إذا تعذّر الوصول إلى RENAPER أو أعاد خطأً، تكون النتيجة REGISTRY_UNAVAILABLE: لم يُتحقق من أي شيء يخص الشخص، ولا تُفرض رسوم على المكالمة. قد ينجح الطلب نفسه عند إعادة المحاولة لاحقاً. راجع رموز النتائج لمعرفة كيفية التعامل مع هذه الحالة.

المستندات التي يقرؤها سير العمل

داخل سير العمل، يُؤخذ رقم DNI والجنس من خطوة التحقق من الهوية، التي تقرأ بطاقة DNI الأرجنتينية وDNI الرقمي. يحمل المقيمون الأجانب بطاقة DNI نفسها ويُتحقق منهم بالطريقة ذاتها. لا يُعد دفتر DNI القديم (libreta) مستنداً مدعوماً في التحقق من الهوية، لذلك لا يستطيع المستخدم الذي يحمل هذا الدفتر وحده إكمال هذه الخطوة. ومع ذلك يمكنك التحقق من رقم DNI الخاص به مباشرة باستخدام POST /v3/database-validation/.

استخدامها في سير العمل

أضف الخدمة إلى خطوة التحقق من قواعد البيانات بعد خطوة التحقق من الهوية. على سبيل المثال، باستخدام POST /v3/workflows/:
إذا كانت خطوة كشف الحيوية قبلها، يقارن RENAPER صورة السيلفي الحية. وإذا لم تكن موجودة، يرسل Didit بدلاً من ذلك الصورة المطبوعة على المستند، وهذا يتحقق من صورة المستند لكنه لا يؤكد أن الشخص أمام الكاميرا هو صاحبه. يُرفض معرّف الخدمة الذي لا يستطيع سير العمل تشغيله بخطأ 400 يذكره، فلا تُحفظ الخطوة من دون الفحص الذي طلبته. راجع إعدادات ميزات سير العمل لمعرفة كل إعدادات التحقق من قواعد البيانات.

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

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