Vai al contenuto principale
POST
Verifica i dati inseriti con l’ente emittente ufficiale della carta d’identità finlandese. 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: Finlandia
  • ID del servizio: fin_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: obbligatorio
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $3.50 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui viene effettuata la query. 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 alcun costo. Per alcuni paesi, questo riguarda una quota rilevante degli utenti reali. Per coprire questi casi, raccogli l’identificativo anche da una risposta al questionario, da un campo di estrazione di Document AI oppure da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio di Validazione su database.

Parametri del corpo della richiesta

string
predefinito:"FIN"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: FIN
string
predefinito:"fin_national_id"
obbligatorio
Array che contiene l’ID di questo servizio. Specificare il servizio mantiene la richiesta limitata a questo specifico database.Esempio: fin_national_id
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:"010190-123A"
obbligatorio
Numero identificativo nazionale per questo servizio.Esempio: 010190-123A
object
Oggetto strutturato con l’indirizzo di residenza. Usa street_1, street_2, city, region, postal_code e country. Una stringa di indirizzo completa in formato legacy è 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 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 i falsi positivi nel rilevamento dei duplicati.Esempio: user-1234

Regole sugli input e note di validazione

  • address è facoltativo per questo servizio. Puoi inviare una 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}[-+A]\d{3}[0-9A-Z]|\d{6}\d{3}[0-9A-Z]).
  • Per i servizi basati sull’indirizzo, invia i campi strutturati dell’indirizzo invece di una singola 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 lo hai.
  • address.city è la città, il quartiere, il distretto, la località o il rione.
  • address.region è lo stato, la provincia, la regione o il comune.
  • address.postal_code è il codice di avviamento postale (CAP).
  • I servizi database basati sull’indirizzo richiedono almeno la via e il codice postale; le richieste rifiutate prima della consultazione della 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 fin_national_id documenta attualmente questa struttura normalizzata:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Prezzi e SLA

Le interrogazioni dell’ID nazionale finlandese vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $3.50 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: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026