Vai al contenuto principale
POST
Il servizio di verifica dei certificati di nascita della DIA. Didit espone questo servizio tramite POST /v3/database-validation/, così puoi confrontare i dati inviati con la fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: ~ 85%
  • Paese: Nuova Zelanda
  • ID servizio: nzl_new_zealand_births
  • Dominio dei dati: Identità
  • Categoria: BirthRecord

Input

  • Input obbligatori: first_name, last_name, date_of_birth
  • Input facoltativi: vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 85%
  • Prezzo: $1.67 per query riuscita

Parametri del body

string
predefinito:"NZL"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: NZL
string
predefinito:"nzl_new_zealand_births"
obbligatorio
Array che contiene l’ID di questo servizio. Vincolare il servizio mantiene la richiesta limitata a questo specifico database.Esempio: nzl_new_zealand_births
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:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli indipendenti allo stesso utente finale e ridurre il rumore dovuto al rilevamento di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Invia i campi elencati sopra esattamente come sono stati raccolti dall’utente o dal documento.
  • Didit convalida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima di consultare la fonte non vengono addebitate.

Come effettuare la chiamata

Dati restituiti

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

Prezzi e SLA

Le query DIA - New Zealand Births vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $1.67 USD.
  • Fatturazione: per query 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à della fonte a valle varia in base al paese e al dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026