Vai al contenuto principale
POST
Risolve persone (nomi, data di nascita, indirizzi, numeri di telefono, email e numeri di identificazione nazionale) e un punteggio di corrispondenza del nome a partire da un’email e/o da un numero di telefono, tramite una rete globale di informazioni sui rischi. L’addebito viene effettuato per ogni richiesta. Didit espone questo servizio tramite POST /v3/database-validation/ in modo che tu possa verificare i dati inviati rispetto alla rete di identità collegata e ricevere risultati di corrispondenza normalizzati. Si tratta di una rete di arricchimento di terze parti, non di un registro governativo autorevole: non presentare i suoi risultati come verifica da fonte primaria.

Copertura

  • Copertura: 50+ mercati
  • Paese: Globale
  • ID servizio: glb_identity_enrichment
  • Dominio dei dati: Identità
  • Categoria: IdentityEnrichment

Input

  • Input obbligatori: nessuno
  • Input facoltativi: email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Consenso: obbligatorio
  • Disponibilità nei workflow: solo API indipendente
  • Copertura: 50+ mercati
  • Prezzo: $0.20 per query riuscita
Questo servizio non è offerto come passaggio di Validazione su database all’interno di un workflow. Ciò limita dove viene eseguito il controllo, non cosa puoi inviargli: chiamalo tramite l’API indipendente, dove fornisci direttamente gli input.

Parametri del corpo della richiesta

string
predefinito:"GLB"
obbligatorio
Codice del paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: GLB
string
predefinito:"glb_identity_enrichment"
obbligatorio
Array che contiene l’ID di questo servizio. Specificare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: glb_identity_enrichment
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"john.doe@example.com"
Indirizzo email.Esempio: john.doe@example.com
string
predefinito:"+15550101000"
Numero di telefono in formato internazionale.Esempio: +15550101000
string
predefinito:"John"
Nome da validare.Esempio: John
string
predefinito:"Doe"
Cognome da validare.Esempio: Doe
string
Nome legale completo da validare.Esempio: John Doe
string
predefinito:"US"
Paese di residenza facoltativo secondo ISO 3166-1 alpha-2. Viene usato solo per focalizzare la ricerca dell’identità.Esempio: US
string
predefinito:"user-1234"
Il tuo riferimento stabile per questa persona, come l’ID utente interno. Didit lo usa per collegare i controlli eseguiti tramite l’API indipendente allo stesso utente finale e ridurre il rumore del rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Fornisci almeno uno tra email o phone: sono le chiavi di ricerca. Una richiesta con entrambi assenti non può eseguire una ricerca di arricchimento e viene rifiutata prima della ricerca presso la fonte (non addebitata).
  • Aggiungi un nome ogni volta che lo hai: la fonte valuta la ricerca in base a esso. Invia first_name e last_name: sono i campi che la mappa validation della risposta confronta. Una richiesta che invia solo full_name viene comunque valutata dalla fonte, ma restituisce una validation vuota e un match_type nullo a livello superiore.
  • country_of_residence è un codice ISO 3166-1 alpha-2 usato per focalizzare la ricerca.
  • Ogni ricerca completata viene addebitata, anche quella che non risolve alcuna persona (persons_found: 0). È gratuita solo una richiesta rifiutata prima della ricerca, cioè quella senza email né phone.

Come effettuare la chiamata

Dati restituiti

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

Prezzi e SLA

Le ricerche Global - Identity Enrichment vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.20 USD.
  • Fatturazione: per ricerca 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.

Prosegui la lettura

Ultima modifica il 7 novembre 2026