Vai al contenuto principale
POST
Verifica i dati inseriti rispetto a un database di un ente governativo che contiene i dati dei cittadini malesi. Didit espone questo servizio tramite POST /v3/database-validation/, così puoi verificare i dati inviati con la fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: > 75%
  • Paese: Malesia
  • ID servizio: mys_national_id
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: full_name, date_of_birth, national_id
  • Input facoltativi: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: > 75%
  • Prezzo: $0.59 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 quota consistente degli utenti reali. Per coprire anche questi casi, raccogli l’identificativo anche da una risposta a un Questionario, da un campo estratto da Document AI oppure da un valore che invii quando crei la sessione, e mappalo nel passaggio Validazione su database.

Parametri del corpo

string
predefinito:"MYS"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: MYS
string
predefinito:"mys_national_id"
obbligatorio
Array che contiene l’ID di questo servizio. Bloccare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: mys_national_id
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 identificativo nazionale per questo servizio.Esempio: 111111111111
object
Oggetto con l’indirizzo di residenza strutturato. 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
Numero di telefono in formato internazionale.Esempio: +15550101000
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 indipendenti allo stesso utente finale e ridurre il rumore dovuto al rilevamento dei duplicati.Esempio: user-1234

Note su regole di input e 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 contenere solo cifre: rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • national_id deve essere lungo esattamente 12 caratteri.
  • 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, compresi il numero civico e il tipo di via.
  • address.street_2 è l’appartamento, l’interno, l’edificio, il piano o una riga aggiuntiva dell’indirizzo. Invialo solo se lo hai.
  • address.city è la città, il sobborgo, il distretto, la località o il quartiere.
  • 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 esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per mys_national_id documenta attualmente questa struttura normalizzata:
  • address
  • address_match_score
  • city
  • date_of_birth
  • identification_number
  • postal_code
  • state
  • street

Prezzi e SLA

Le query per il Malaysia National ID vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.59 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à delle fonti a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026