Vai al contenuto principale
POST
Verifica i dati di input rispetto a un ente governativo. Didit espone questo servizio tramite POST /v3/database-validation/ in modo che tu possa verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: ~ 90%
  • Paese: Indonesia
  • ID servizio: idn_residential_identity_card
  • Dominio dei dati: Indirizzo
  • Categoria: Residenziale

Input

  • Input obbligatori: full_name, date_of_birth, national_id, address.street_1, address.postal_code
  • Input facoltativi: address.street_2, address.city, address.region, gender, vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 90%
  • Prezzo: $0.35 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: non viene interrogato alcun database e non ti viene addebitato nulla. Per alcuni paesi, questo riguarda una quota rilevante degli utenti reali. Per coprire anche questi casi, raccogli l’identificativo anche da una risposta del questionario, da un campo estratto da Document AI o da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio di Validazione su database.

Parametri del body

string
predefinito:"IDN"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: IDN
string
predefinito:"idn_residential_identity_card"
obbligatorio
Array contenente questo ID servizio. Specificare il servizio limita la richiesta esattamente a questo database.Esempio: idn_residential_identity_card
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"John Doe"
obbligatorio
Nome completo ufficiale 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:"1111111111111111"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio: 1111111111111111
object
obbligatorio
Oggetto strutturato dell’indirizzo residenziale. Usa street_1, street_2, city, region, postal_code e country. Una stringa di indirizzo completa nel formato precedente è 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
Valore del sesso, quando richiesto dal database.Valori consentiti: M (maschio), F (femmina), X (altro o sconosciuto).Esempio: M
string
predefinito:"user-1234"
Il tuo identificativo 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 segnali nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • national_id deve contenere solo cifre; rimuovi spazi, trattini e segni di punteggiatura prima di inviare la richiesta.
  • national_id deve essere lungo esattamente 16 caratteri.
  • 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 se 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 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 esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per idn_residential_identity_card documenta attualmente questa struttura normalizzata:
  • address_match_score
  • date_of_birth
  • identification_number

Prezzi e SLA

Le query sulla Carta d’identità residenziale dell’Indonesia vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.35 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à delle fonti a valle varia a seconda del paese e del dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026