الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل هيئة AFIP (Administracion Federal de Ingresos Publicos). تتيح لك Didit هذه الخدمة عبر POST /v3/database-validation/ للتحقق من البيانات المُرسلة مقابل المصدر الرسمي والحصول على نتائج مطابقة موحّدة. صيغة الإدخال: يقبل document_number رقم DNI الأرجنتيني (من 7 إلى 8 أرقام، مع بادئة M/F اختيارية).

التغطية

  • التغطية: ~ 90%
  • الدولة: الأرجنتين
  • معرّف الخدمة: arg_citizens
  • نطاق البيانات: الهوية
  • الفئة: المواطنة

المدخلات

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

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

string
افتراضي:"ARG"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ARG
string
افتراضي:"arg_citizens"
مطلوب
مصفوفة تحتوي على معرّف الخدمة هذا. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه.مثال: arg_citizens
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"11111111"
مطلوب
رقم المستند المستخرج من مستند أو المقدَّم من المستخدم.مثال: 11111111
string
افتراضي:"user-1234"
المرجع الثابت للمستخدم لدى نظامك، مثل معرّف المستخدم الداخلي. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

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

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

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

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

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

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

تُحتسب استعلامات Argentina Citizens (AFIP) فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • سعر الاستدعاء: $3.17 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب رسوم عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: المعتاد p95 < 2 s.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit، ويختلف توفر المصدر الخارجي حسب الدولة ومجموعة البيانات.

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

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