Vai al contenuto principale
POST
Verifica una credenziale elettorale INE / IFE messicana rispetto al registro INE (modello, vigenza, validità come documento di identificazione, diritto di voto). Didit espone questo servizio tramite POST /v3/database-validation/ per confrontare i dati inviati con la fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: —
  • Paese: Messico
  • ID servizio: mex_ine_vigencia
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: —
  • Input facoltativi: cic, identificador_ciudadano, ocr, voter_number, emission_number, first_name, last_name, date_of_birth, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: —
  • Prezzo: $0.20 per query riuscita

Parametri del body

string
predefinito:"MEX"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: MEX
string
predefinito:"mex_ine_vigencia"
obbligatorio
Array contenente questo ID del servizio. Specificare il servizio limita la richiesta a questo database specifico.Esempio: mex_ine_vigencia
string
predefinito:"123456789"
Valore cic richiesto da questo servizio di database.Esempio: 123456789
string
Valore identificador_ciudadano richiesto da questo servizio di database.Esempio: 123456789
string
Valore ocr richiesto da questo servizio di database.Esempio: 1234567890123
string
Valore voter_number richiesto da questo servizio di database.Esempio: ABCDEF123456
string
Valore emission_number richiesto da questo servizio di database.Esempio: 01
string
Nome da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
string
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare le verifiche indipendenti allo stesso utente finale e ridurre i falsi rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Fornisci almeno un identificatore della credenziale: cic, identificador_ciudadano, ocr o voter_number. Se sono tutti assenti, Didit restituisce HTTP 400 con i campi accettati invece di chiamare il provider. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.
  • Per una credenziale legacy identificata tramite voter_number, includi emission_number.
  • Un rifiuto da parte del provider resta una validazione completata con HTTP 200 e contiene il risultato normalizzato reale. Ad esempio, il codice del provider 4 viene restituito come outcome_code: "INVALID_DOCUMENT_FORMAT", outcome_detail: "4" e source_data.message: "Error de datos". Usa questi campi invece di trattare ogni rifiuto come un generico errore di disponibilità.
  • Il codice del provider 0 indica che la credenziale inviata non è stata trovata. Viene restituito come outcome_code: "DOCUMENT_NOT_FOUND", con outcome_detail: "0" e la spiegazione originale in source_data.message.
  • I codici del provider 1 e 10 indicano che i dati della credenziale inviata non corrispondono al record INE. Vengono restituiti come outcome_code: "NO_MATCH", con il codice del provider in outcome_detail e la spiegazione originale in source_data.message.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per mex_ine_vigencia documenta attualmente questa struttura normalizzata:
  • emission_number
  • emission_year
  • expiration_date
  • federal_district
  • identification_number
  • message
  • message_code
  • ocr
  • registration_year
  • validation_code
  • voter_number

Prezzi e SLA

Le interrogazioni di verifica della validità della credenziale INE in Messico vengono fatturate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.20 USD.
  • Fatturazione: per interrogazione riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità delle fonti a valle varia in base al paese e al set di dati.

Continua a leggere

Ultima modifica il 7 novembre 2026