Saltar al contingut principal
POST
Verifica una credencial d’elector de l’INE / IFE de Mèxic contra el registre de l’INE (model, vigència, vàlida com a identificació, dret a vot). Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades contra la font autoritzada i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: —
  • País: Mèxic
  • ID del servei: mex_ine_vigencia
  • Àmbit de dades: Identitat
  • Categoria: NationalIDRegistry

Entrades

  • Entrades obligatòries: —
  • Entrades opcionals: cic, identificador_ciudadano, ocr, voter_number, emission_number, first_name, last_name, date_of_birth, vendor_data
  • Consentiment: No cal
  • Disponibilitat: Disponible en el flux de treball
  • Cobertura: —
  • Preu: $0.20 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"MEX"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: MEX
string
predeterminat:"mex_ine_vigencia"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: mex_ine_vigencia
string
predeterminat:"123456789"
Valor de cic que requereix aquest servei de base de dades.Exemple: 123456789
string
Valor de identificador_ciudadano que requereix aquest servei de base de dades.Exemple: 123456789
string
Valor de ocr que requereix aquest servei de base de dades.Exemple: 1234567890123
string
Valor de voter_number que requereix aquest servei de base de dades.Exemple: ABCDEF123456
string
Valor de emission_number que requereix aquest servei de base de dades.Exemple: 01
string
Nom de pila a validar.Exemple: John
string
Cognoms a validar.Exemple: Doe
string
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"user-1234"
La teva referència d’usuari estable per a aquesta persona, com ara el teu ID intern d’usuari. Didit l’utilitza per vincular les comprovacions independents al mateix usuari final i reduir el soroll de la detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • Proporciona com a mínim un identificador de credencial: cic, identificador_ciudadano, ocr o voter_number. Si tots estan absents, Didit retorna HTTP 400 amb els camps acceptats en lloc de cridar el proveïdor. Les sol·licituds rebutjades abans de la consulta a la font no es facturen.
  • Per a una credencial antiga identificada per voter_number, inclou emission_number.
  • Un rebuig del proveïdor continua sent una validació HTTP 200 completada i inclou el resultat normalitzat real. Per exemple, el codi de proveïdor 4 es retorna com a outcome_code: "INVALID_DOCUMENT_FORMAT", outcome_detail: "4" i source_data.message: "Error de datos". Utilitza aquests camps en lloc de tractar cada rebuig com un error genèric de disponibilitat.
  • El codi de proveïdor 0 significa que no s’ha trobat la credencial enviada. Es retorna com a outcome_code: "DOCUMENT_NOT_FOUND", amb outcome_detail: "0" i l’explicació original a source_data.message.
  • Els codis de proveïdor 1 i 10 signifiquen que les dades de credencial enviades no coincideixen amb el registre de l’INE. Es retornen com a outcome_code: "NO_MATCH", amb el codi de proveïdor a outcome_detail i l’explicació original a source_data.message.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a mex_ine_vigencia documenta actualment aquesta estructura normalitzada:
  • emission_number
  • emission_year
  • expiration_date
  • federal_district
  • identification_number
  • message
  • message_code
  • ocr
  • registration_year
  • validation_code
  • voter_number

Preus i SLA

Les consultes de verificació de la vigència de la credencial INE de Mèxic només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.20 USD.
  • Facturació: per consulta satisfactòria. No se’t cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típic inferior a 2 s.
  • Disponibilitat: 99.9% per trimestre a la part de Didit; la disponibilitat de la font de la qual depèn el servei varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026