Vai al contenuto principale
POST
Verifica i dati inseriti rispetto al Document Verification Service (DVS). Didit espone questo servizio tramite POST /v3/database-validation/, così puoi verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: 100%*
  • Paese: Australia
  • ID servizio: aus_birth_certificate
  • Dominio dei dati: Identità
  • Categoria: BirthRecord

Input

  • Input obbligatori: first_name, last_name, date_of_birth, birth_registration_number, birth_registration_date, birth_registration_state
  • Input facoltativi: middle_name, vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow con mappatura dei campi
  • Copertura: 100%*
  • Prezzo: $0.75 per query riuscita
In un workflow, birth_registration_date e birth_registration_state non sono stampati su un documento d’identità, quindi nessun passaggio li produce da solo. Raccoglili da una risposta del questionario, da un campo estratto da Document AI oppure da un valore che invii al momento della creazione della sessione, e mappa ciascuno di essi nel passaggio Validazione su database. Finché non sono mappati, l’editor del workflow mostra questo servizio disabilitato e indica l’input mancante; in fase di esecuzione un input mancante significa che il controllo viene saltato prima di qualsiasi query, quindi non ti viene mai addebitato un database che non avrebbe potuto essere interrogato.

Parametri del body

string
predefinito:"AUS"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: AUS
string
predefinito:"aus_birth_certificate"
obbligatorio
Array contenente l’ID di questo servizio. Specificare il servizio limita la richiesta esattamente a questo database.Esempio: aus_birth_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-BIRTH-12345"
obbligatorio
Valore birth_registration_number richiesto da questo servizio di database.Esempio: SAMPLE-BIRTH-12345
string
predefinito:"1990-01-01"
obbligatorio
Valore birth_registration_date richiesto da questo servizio di database.Esempio: 1990-01-01
string
predefinito:"Sample State"
obbligatorio
Valore birth_registration_state richiesto da questo servizio di database.Esempio: Sample State
string
Secondo nome, quando disponibile.Esempio: Demo
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dei rilevamenti di 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 valida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

Come richiamarlo

Dati restituiti

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

Prezzi e SLA

Le query Australia - DVS - Birth Certificate vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.75 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene respinta 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 a leggere

Ultima modifica il 7 novembre 2026