Vai al contenuto principale
POST
Verifica i dati inseriti rispetto al servizio dati ufficiale in Cina. 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. Formato di input: date_of_birth accetta la data di nascita, che deve corrispondere alla data di nascita codificata nel numero di identità nazionale cinese (cifre 7-14 di un numero di 18 caratteri, cifre 7-12 di un numero nel vecchio formato a 15 cifre).

Copertura

  • Copertura: ~ 100%
  • Paese: Cina
  • ID servizio: chn_passport_verification
  • Dominio dei dati: Documento
  • Categoria: Passaporto

Input

  • Input obbligatori: full_name, date_of_birth, national_id, passport_number
  • Input facoltativi: vendor_data
  • Consenso: obbligatorio
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $1.67 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui il servizio effettua 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 consistente degli utenti reali. Per coprire 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 al momento della creazione della sessione, e mappalo nel passaggio Validazione su database.

Parametri del body

string
predefinito:"CHN"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: CHN
string
predefinito:"chn_passport_verification"
obbligatorio
Array che contiene questo ID servizio. Vincolare il servizio mantiene la richiesta limitata a questo specifico database.Esempio: chn_passport_verification
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"王新伟"
obbligatorio
Nome legale completo da validare.Esempio: 王新伟
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"11010519900101003X"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio: 11010519900101003X
string
predefinito:"SAMPLE-PASS-12345"
obbligatorio
Numero di passaporto.Esempio: SAMPLE-PASS-12345
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

Regole di input e note sulla validazione

  • La data di nascita deve corrispondere alla data di nascita codificata nel numero di identità nazionale cinese (cifre 7-14 di un numero di 18 caratteri, cifre 7-12 di un numero nel vecchio formato a 15 cifre)
  • date_of_birth deve corrispondere alla data di nascita codificata in national_id; la fonte rifiuta la richiesta direttamente quando i due valori non coincidono, quindi una mancata corrispondenza viene respinta prima della ricerca e non viene addebitata.
  • national_id deve corrispondere a (?:\d{15}|\d{17}[\dXx]).
  • Viene validato il carattere di controllo finale della Carta d’identità di residente cinese.
  • full_name deve essere il nome in caratteri cinesi originali, così come compare nel registro o sul documento. Non inviare la traslitterazione latina per i controlli sui database cinesi.

Come effettuare la chiamata

Dati restituiti

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

Prezzi e SLA

Le query di China Passport Verification vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $1.67 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene respinta prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre dal lato di Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026