Vai al contenuto principale
POST
Servizio aggregato di registri pubblici e governativi, registri dei precedenti e altri servizi. 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.

Copertura

  • Copertura: ~ 85%
  • Paese: Stati Uniti
  • ID servizio: usa_states_financial_services
  • Dominio dei dati: Finanziario
  • Categoria: FinancialServices

Input

  • Input obbligatori: first_name, last_name, date_of_birth
  • Input facoltativi: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, ssn, email, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 85%
  • Prezzo: $0.20 per query riuscita

Parametri del corpo della richiesta

string
predefinito:"USA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: USA
string
predefinito:"usa_states_financial_services"
obbligatorio
Array che contiene l’ID del servizio. Vincolare il servizio limita la richiesta esattamente a questo database.Esempio: usa_states_financial_services
string
predefinito:"John"
obbligatorio
Nome da validare.Esempio: John
string
predefinito:"Doe"
obbligatorio
Cognome da validare.Esempio: Doe
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
object
Oggetto strutturato per l’indirizzo di residenza. Usa street_1, street_2, city, region, postal_code e country. Una stringa di indirizzo completa in formato legacy è ancora accettata, ma non consigliata.Esempio: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Numero di telefono in formato internazionale.Esempio: +15550101000
string
Valore ssn richiesto da questo servizio di database.Esempio: 123456789
string
Indirizzo email.Esempio: john.doe@example.com
string
predefinito:"user-1234"
Il tuo riferimento 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 positivi nel rilevamento dei duplicati.Esempio: user-1234

Regole per gli input e note sulla validazione

  • address è facoltativo per questo servizio. Puoi inviare una stringa address completa e Didit la suddividerà in elementi di indirizzo strutturati quando possibile, oppure puoi inviare esplicitamente i campi strutturati.
  • Numero di previdenza sociale statunitense o ITIN: 9 cifre complete (i trattini sono facoltativi) oppure solo le ultime 4 cifre
  • ssn deve corrispondere a (?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4}).
  • Per ssn, invia l’SSN o ITIN completo di 9 cifre (i trattini sono facoltativi) oppure solo le ultime 4 cifre.
  • Questo servizio richiede first_name, last_name e date_of_birth, che soddisfano già il minimo previsto dalla fonte, ovvero un nome più un altro campo identificativo. I campi facoltativi (ssn, address, phone, email) rafforzano ulteriormente la corrispondenza.
  • Per i servizi basati sull’indirizzo, invia i campi strutturati dell’indirizzo invece di una singola stringa address quando possibile.
  • address.street_1 è l’indirizzo stradale, incluso il numero civico e il tipo di via.
  • address.street_2 è l’interno, l’unità, l’edificio, il piano o una riga aggiuntiva dell’indirizzo. Invialo solo se lo hai.
  • address.city è la città, il sobborgo, il distretto, la località o il quartiere.
  • address.region è lo stato, la provincia, la regione o il comune.
  • address.postal_code è il codice di avviamento postale o il CAP.
  • I servizi di database basati sull’indirizzo richiedono almeno l’indirizzo stradale e il codice postale; le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

Come effettuare la chiamata

Dati restituiti

I campi esatti che compaiono in source_data dipendono da ciò che restituisce il registro. L’esempio generato per usa_states_financial_services documenta al momento questa struttura normalizzata:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • state
  • street

Prezzi e SLA

Stati Uniti d’America - Servizi finanziari degli Stati Uniti: le interrogazioni vengono fatturate solo quando Didit riceve un risultato conclusivo 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 dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026