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/ così da poter confrontare i dati inviati con la 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 documento d’identità nazionale cinese (cifre dalla 7 alla 14 di un numero di 18 caratteri, dalla 7 alla 12 di un numero legacy di 15 cifre).

Copertura

  • Copertura: ~ 100%
  • Paese: Cina
  • ID del servizio: chn_national_id
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: full_name, date_of_birth, national_id
  • Input facoltativi: vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $0.50 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui viene effettuata 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. Per alcuni paesi questa situazione riguarda una quota rilevante degli utenti reali. Per coprire questi casi, raccogli l’identificativo anche da una risposta nei Questionari, da un campo estratto da Document AI o da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio Validazione su database.

Parametri del corpo

string
predefinito:"CHN"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: CHN
string
predefinito:"chn_national_id"
obbligatorio
Array contenente l’ID di questo servizio. Vincolare il servizio limita la richiesta a questo specifico database.Esempio: chn_national_id
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:"user-1234"
Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli indipendenti allo stesso utente finale e ridurre il rumore dovuto ai rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • La data di nascita deve corrispondere alla data di nascita codificata nel documento d’identità nazionale cinese (cifre dalla 7 alla 14 di un numero di 18 caratteri, dalla 7 alla 12 di un numero legacy di 15 cifre)
  • date_of_birth deve corrispondere alla data di nascita codificata in national_id; la fonte rifiuta la richiesta immediatamente 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à dei residenti cinesi.
  • full_name deve essere il nome originale in caratteri cinesi, così com’è riportato nel registro o sul documento. Non inviare la traslitterazione latina per i controlli sul database cinese.

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_national_id documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • identification_number

Prezzi e SLA

Le query sul numero di identità nazionale cinese vengono fatturate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.50 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 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