Vai al contenuto principale
POST
Verifica i dati del codice unico di identificazione guatemalteco rispetto ai registri governativi SAT. Didit espone questo servizio tramite POST /v3/database-validation/ in modo che tu possa verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato di input: document_number accetta il DPI guatemalteco (esattamente 13 cifre).

Copertura

  • Copertura: 90-95%
  • Paese: Guatemala
  • ID servizio: gtm_dpi
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: document_number, date_of_birth
  • Input facoltativi: first_name, last_name, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: 90-95%
  • Prezzo: $0.20 per query riuscita

Parametri del body

string
predefinito:"GTM"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: GTM
string
predefinito:"gtm_dpi"
obbligatorio
Array contenente questo ID servizio. Impostare il servizio limita la richiesta esattamente a questo database.Esempio: gtm_dpi
string
predefinito:"1111111111111"
obbligatorio
Numero del documento estratto o fornito dall’utente.Esempio: 1111111111111
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
Nome di battesimo da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
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 segnali del rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • DPI guatemalteco (esattamente 13 cifre)
  • document_number deve contenere solo cifre; rimuovi spazi, trattini e segni di punteggiatura prima di inviare la richiesta.
  • document_number deve essere lungo esattamente 13 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per gtm_dpi documenta attualmente questa struttura normalizzata:
  • first_name
  • full_name
  • identification_number
  • last_name

Prezzi e SLA

Le query di verifica del DPI del Guatemala vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.20 USD.
  • Fatturazione: per query 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à della fonte a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026