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

التغطية

  • التغطية: —
  • الدولة: المكسيك
  • معرّف الخدمة: mex_ine_vigencia
  • نطاق البيانات: الهوية
  • الفئة: NationalIDRegistry

الحقول المدخلة

  • الحقول المطلوبة: —
  • الحقول الاختيارية: cic، وidentificador_ciudadano، وocr، وvoter_number، وemission_number، وfirst_name، وlast_name، وdate_of_birth، وvendor_data
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: —
  • السعر: $0.20 لكل استعلام ناجح

معلمات الجسم

string
افتراضي:"MEX"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: MEX
string
افتراضي:"mex_ine_vigencia"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يحصر الطلب بقاعدة البيانات هذه بالتحديد.مثال: mex_ine_vigencia
string
افتراضي:"123456789"
القيمة cic المطلوبة من خدمة قاعدة البيانات هذه.مثال: 123456789
string
القيمة identificador_ciudadano المطلوبة من خدمة قاعدة البيانات هذه.مثال: 123456789
string
القيمة ocr المطلوبة من خدمة قاعدة البيانات هذه.مثال: 1234567890123
string
القيمة voter_number المطلوبة من خدمة قاعدة البيانات هذه.مثال: ABCDEF123456
string
القيمة emission_number المطلوبة من خدمة قاعدة البيانات هذه.مثال: 01
string
الاسم الأول المراد التحقق منه.مثال: John
string
اسم العائلة المراد التحقق منه.مثال: Doe
string
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"user-1234"
مرجعك الثابت للمستخدم، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل ضجيج اكتشاف التكرار.مثال: user-1234

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

  • أرسل معرّف بيانات اعتماد واحداً على الأقل: cic، أو identificador_ciudadano، أو ocr، أو voter_number. إذا غابت جميعها، تُرجع Didit الرمز HTTP 400 مع الحقول المقبولة بدلاً من استدعاء المزوّد. لا تُحتسب الطلبات المرفوضة قبل البحث في المصدر.
  • بالنسبة إلى بيانات اعتماد قديمة يُحدَّد بها voter_number، أدرج emission_number.
  • يبقى رفض المزوّد تحققاً مكتملاً بالرمز HTTP 200 ويحمل النتيجة الموحّدة الفعلية. فمثلاً، يُعاد الرمز 4 من المزوّد على أنه outcome_code: "INVALID_DOCUMENT_FORMAT"، وoutcome_detail: "4"، وsource_data.message: "Error de datos". استخدم هذه الحقول بدلاً من معاملة كل رفض على أنه خطأ توفّر عام.
  • يعني الرمز 0 من المزوّد أن بيانات الاعتماد المُرسلة غير موجودة. يُعاد على أنه outcome_code: "DOCUMENT_NOT_FOUND"، مع outcome_detail: "0" والشرح الأصلي في source_data.message.
  • تعني الرموز 1 و10 من المزوّد أن بيانات الاعتماد المُرسلة لا تطابق سجل INE. تُعاد على أنها outcome_code: "NO_MATCH"، مع رمز المزوّد في outcome_detail والشرح الأصلي في source_data.message.

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُعيده السجل. يوثّق المثال المُولَّد للخدمة mex_ine_vigencia حالياً هذا الشكل الموحّد:
  • emission_number
  • emission_year
  • expiration_date
  • federal_district
  • identification_number
  • message
  • message_code
  • ocr
  • registration_year
  • validation_code
  • voter_number

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

لا تُحتسب استعلامات التحقق من صلاحية بطاقة INE في المكسيك إلا عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.20 USD.
  • الفوترة: لكل استعلام ناجح. لا تُفرض عليك رسوم عند تعذر الوصول إلى السجل، أو عند نقص الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: عادةً ما يكون زمن الاستجابة عند المئين 95 أقل من ثانيتين.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر النهائي بحسب الدولة ومجموعة البيانات.

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

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