Vai al contenuto principale
POST
Verifica i dati inseriti rispetto al Document Verification Service (DVS). 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: 100%*
  • Paese: Australia
  • ID servizio: aus_change_of_name_certificate
  • Dominio dati: Identità
  • Categoria: CivilRegistry

Input

  • Input obbligatori: first_name, last_name, date_of_birth, change_of_name_certificate_number
  • Input facoltativi: vendor_data
  • Consenso: obbligatorio
  • Disponibilità nel workflow: disponibile nel workflow con mappatura dei campi
  • Copertura: 100%*
  • Prezzo: $0.75 per interrogazione riuscita
In un workflow, change_of_name_certificate_number non è stampato su un documento d’identità, quindi nessun passaggio lo produce da solo. Raccoglilo da una risposta a un Questionario, da un campo di estrazione di Document AI oppure da un valore che invii alla creazione della sessione, e mappalo nel passaggio Validazione su database. Finché non è mappato, l’editor del workflow mostra questo servizio disabilitato e indica l’input mancante; in fase di esecuzione un input mancante fa sì che il controllo venga saltato prima di qualsiasi interrogazione, quindi non ti viene mai addebitata un’interrogazione a un database che non è stato possibile interrogare.

Parametri del corpo

string
predefinito:"AUS"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: AUS
string
predefinito:"aus_change_of_name_certificate"
obbligatorio
Array che contiene questo ID servizio. Specificare esplicitamente il servizio mantiene la richiesta limitata a questo specifico database.Esempio: aus_change_of_name_certificate
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
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
string
predefinito:"SAMPLE-CON-12345"
obbligatorio
Valore di change_of_name_certificate_number richiesto da questo servizio di database.Esempio: SAMPLE-CON-12345
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli eseguiti autonomamente allo stesso utente finale e ridurre il rumore dovuto ai duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Invia i campi elencati sopra esattamente come acquisiti dall’utente o dal documento.
  • Didit convalida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

Come effettuare la chiamata

Dati restituiti

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

Prezzi e SLA

Australia - DVS - Certificato di cambio di nome: le interrogazioni vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.75 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: tipicamente p95 inferiore a 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità delle fonti a valle varia per paese e per dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026