Vai al contenuto principale
POST
Verifica il numero Aadhaar inserito rispetto ai registri di identità UIDAI. 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: ~ 100%
  • Paese: India
  • ID servizio: ind_aadhaar
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: full_name, date_of_birth, personal_number, pan
  • Input facoltativi: vendor_data
  • Consenso: obbligatorio
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $0.42 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui viene interrogato. Quando l’identificativo non viene estratto dal documento, il controllo viene registrato come non applicabile: nessun database viene interrogato e non ti viene addebitato alcun costo. In alcuni paesi questo riguarda una quota consistente degli utenti reali. Per coprire 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 body

string
predefinito:"IND"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: IND
string
predefinito:"ind_aadhaar"
obbligatorio
Array contenente questo ID servizio. Specificare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: ind_aadhaar
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"John Doe"
obbligatorio
Nome legale completo da validare.Esempio: John Doe
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"111111111111"
obbligatorio
Numero di identità personale specifico del paese.Esempio: 111111111111
string
predefinito:"ABCDE1234F"
obbligatorio
Permanent Account Number.Esempio: ABCDE1234F
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 delle rilevazioni di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • pan deve contenere solo lettere maiuscole.
  • pan deve corrispondere a [A-Z]{5}\d{4}[A-Z].
  • personal_number deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • personal_number deve essere esattamente di 12 caratteri.

Come effettuare la chiamata

Dati restituiti

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

Prezzi e SLA

Le query Aadhaar (UIDAI) per l’India vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.42 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 inferiore a 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