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ì da poter verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: 100%*
  • Paese: Australia
  • ID servizio: aus_marriage_certificate
  • Dominio dati: Identità
  • Categoria: CivilRegistry

Input

  • Input obbligatori: first_name, last_name, first_partner_name, last_partner_name, marriage_certificate_number, birth_registration_number, birth_registration_state, birth_registration_date
  • Input facoltativi: 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, first_partner_name, last_partner_name, birth_registration_state e birth_registration_date non sono riportati su un documento d’identità, quindi nessun passaggio li produce da solo. Raccoglili 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 mappa ciascuno 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 comporta che il controllo venga saltato prima di qualsiasi query, quindi non ti viene addebitato un database che non poteva 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_marriage_certificate"
obbligatorio
Array che contiene questo ID del servizio. Vincolando il servizio, la richiesta viene limitata a questo database specifico.Esempio: aus_marriage_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:"Jamie"
obbligatorio
Valore di first_partner_name richiesto da questo servizio di database.Esempio: Jamie
string
predefinito:"Example"
obbligatorio
Valore di last_partner_name richiesto da questo servizio di database.Esempio: Example
string
predefinito:"SAMPLE-MARRIAGE-12345"
obbligatorio
Valore di marriage_certificate_number richiesto da questo servizio di database.Esempio: SAMPLE-MARRIAGE-12345
string
predefinito:"SAMPLE-BIRTH-12345"
obbligatorio
Valore di birth_registration_number richiesto da questo servizio di database.Esempio: SAMPLE-BIRTH-12345
string
predefinito:"Sample State"
obbligatorio
Valore di birth_registration_state richiesto da questo servizio di database.Esempio: Sample State
string
predefinito:"1990-01-01"
obbligatorio
Valore di birth_registration_date richiesto da questo servizio di database.Esempio: 1990-01-01
string
predefinito:"user-1234"
Il tuo riferimento stabile per questa persona, ad esempio 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 sugli 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 interrogare 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_marriage_certificate documenta attualmente questa forma normalizzata:
  • first_name
  • identification_number
  • last_name

Prezzi e SLA

Le query Australia - DVS – Marriage Certificate vengono fatturate solo quando Didit riceve un risultato definitivo 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 i campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre dal lato di Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026