Vai al contenuto principale
POST
Verifica una patente di guida o una carta d’identità statale statunitense rispetto ai registri della motorizzazione dello stato di emissione, confermando il numero della patente, il nome e cognome del titolare e la data di nascita. Didit mette a disposizione questo servizio tramite POST /v3/database-validation/ per consentirti di verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato di input: document_number accetta il numero della patente di guida o della carta d’identità statale statunitense (da 4 a 20 lettere e cifre; trattini e spazi consentiti).

Copertura

  • Copertura: ~ 90%
  • Paese: Stati Uniti
  • ID servizio: usa_driver_license_dmv
  • Dominio dati: Documento
  • Categoria: DriverLicence

Input

  • Input obbligatori: first_name, last_name, document_number, driver_license_state
  • Input facoltativi: middle_name, date_of_birth, date_of_issue, expiration_date, gender, document_type, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nei workflow: Disponibile nei workflow
  • Copertura: ~ 90%
  • Prezzo: $1.99 per richiesta riuscita

Parametri del body

string
predefinito:"USA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: USA
string
predefinito:"usa_driver_license_dmv"
obbligatorio
Array contenente l’ID di questo servizio. Specificare il servizio limita la richiesta a questo preciso database.Esempio: usa_driver_license_dmv
string
predefinito:"John"
obbligatorio
Nome da validare.Esempio: John
string
predefinito:"Doe"
obbligatorio
Cognome da validare.Esempio: Doe
string
predefinito:"SAMPLE-DOC-12345"
obbligatorio
Numero del documento estratto o fornito dall’utente.Esempio: SAMPLE-DOC-12345
string
predefinito:"Sample State"
obbligatorio
Stato o regione che ha rilasciato la patente di guida.Esempio: Sample State
string
Secondo nome, se disponibile.Esempio: Demo
string
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
Valore date_of_issue richiesto da questo servizio di database.Esempio: 1990-01-01
string
Valore expiration_date richiesto da questo servizio di database.Esempio: 1990-01-01
string
Valore del genere, se richiesto dal database.Valori consentiti: M (maschile), F (femminile), X (altro o sconosciuto).Esempio: M
string
Tipo di documento da validare rispetto a questo servizio di database.Valori consentiti: DL (patente di guida), ID (documento d’identità nazionale).Esempio: DL
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare controlli indipendenti allo stesso utente finale e ridurre i falsi segnali nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Numero della patente di guida o del documento d’identità statale statunitense (4-20 lettere e cifre; trattini e spazi consentiti)
  • document_number deve essere lungo da 4 a 20 caratteri.
  • document_number deve corrispondere a [A-Za-z0-9][A-Za-z0-9 -]{2,18}[A-Za-z0-9].
  • Invia driver_license_state come codice a due lettere dello stato di emissione (TX) o nome (Texas).
  • Le patenti della California e della Pennsylvania non vengono verificate da questo servizio.

Come chiamarlo

Dati restituiti

I campi esatti presenti in source_data dipendono da quanto restituito dal registro. L’esempio generato per usa_driver_license_dmv documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • middle_name

Prezzi e SLA

Le interrogazioni per gli Stati Uniti relative alle patenti di guida (DMV) vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $1.99 USD.
  • Fatturazione: per ogni interrogazione riuscita. Non ti viene addebitato alcun costo quando il registro non è raggiungibile, quando mancano i campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre da parte di Didit; la disponibilità della fonte a valle varia in base al paese e al set di dati.

Continua a leggere

Ultima modifica il 9 novembre 2026