Vai al contenuto principale
POST
Verifica i dati inseriti rispetto al servizio Civil Registration. Didit espone questo servizio tramite POST /v3/database-validation/ in modo che tu possa confrontare i dati inviati con la fonte autorevole e ricevere risultati normalizzati del confronto.

Copertura

  • Copertura: ~ 100%
  • Paese: Danimarca
  • ID servizio: dnk_national_id
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: first_name, last_name, date_of_birth, national_id
  • Input facoltativi: address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $2.32 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui il servizio effettua la ricerca. Quando l’identificativo non viene estratto dal documento, il controllo viene registrato come non applicabile: non viene interrogato alcun database e non ti viene addebitato nulla. In alcuni paesi questo riguarda una parte consistente degli utenti reali. Per coprire anche questi casi, raccogli l’identificativo anche da una risposta di un questionario, da un campo di estrazione di Document AI oppure da un valore che invii quando crei la sessione, e mappalo nel passaggio Validazione su database.

Parametri del corpo

string
predefinito:"DNK"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: DNK
string
predefinito:"dnk_national_id"
obbligatorio
Array che contiene questo ID servizio. Specificare il servizio limita la richiesta a questo database esatto.Esempio: dnk_national_id
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:"0101901234"
obbligatorio
Numero identificativo nazionale per questo servizio.Esempio: 0101901234
object
Oggetto strutturato dell’indirizzo di residenza. Usa street_1, street_2, city, region, postal_code e country. Una stringa di indirizzo completa nel vecchio formato è ancora accettata ma non è consigliata.Esempio: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
predefinito:"user-1234"
Il tuo riferimento stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare le verifiche autonome allo stesso utente finale e ridurre i falsi positivi nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note sulla validazione

  • address è facoltativo per questo servizio. Puoi inviare un’unica stringa address completa e Didit la suddividerà in elementi strutturati dell’indirizzo quando possibile, oppure puoi inviare esplicitamente i campi strutturati.
  • national_id deve corrispondere a \d{6}-?\d{4}.
  • Per i servizi basati sull’indirizzo, invia i campi strutturati dell’indirizzo invece di un’unica stringa address, quando possibile.
  • address.street_1 è l’indirizzo stradale, incluso il numero civico e il tipo di via.
  • address.street_2 è l’interno, l’unità, l’edificio, il piano o una riga aggiuntiva dell’indirizzo. Invialo solo quando ce l’hai.
  • address.city è la città, il quartiere, il distretto, la località o il rione.
  • address.region è lo stato, la provincia, la regione o la cittadina.
  • address.postal_code è il CAP o il codice postale.
  • I servizi di database basati sull’indirizzo richiedono almeno l’indirizzo stradale e il codice postale; le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

Come effettuare la chiamata

Dati restituiti

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

Prezzi e SLA

Le query per l’ID nazionale danese vengono fatturate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.
  • Prezzo per chiamata: $2.32 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 la lettura

Ultima modifica il 7 novembre 2026