Saltar al contingut principal
POST
Verifica les dades d’entrada amb el servei oficial de dades de la Xina. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades contra la font autoritzada i rebre resultats de coincidència normalitzats. Format d’entrada: el camp date_of_birth ha de coincidir amb la data de naixement codificada al número d’identitat nacional xinès (dígits 7 a 14 d’un número de 18 caràcters, 7 a 12 d’un número antic de 15 dígits).

Cobertura

  • Cobertura: ~ 100%
  • País: Xina
  • ID del servei: chn_passport_verification
  • Àmbit de dades: Document
  • Categoria: Passaport

Entrades

  • Entrades obligatòries: full_name, date_of_birth, national_id, passport_number
  • Entrades opcionals: vendor_data
  • Consentiment: Obligatori
  • Disponibilitat en el flux de treball: Disponible en el flux de treball
  • Cobertura: ~ 100%
  • Preu: $1.67 per consulta satisfactòria
No tots els documents que accepta aquest servei contenen l’identificador amb què es consulta. Quan l’identificador no s’extreu del document, la comprovació es registra com a no aplicable: no es consulta cap base de dades i no pagues res. En alguns països, això representa una part important dels usuaris reals. Per cobrir-los, recull també l’identificador d’una resposta d’un Qüestionari, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i mapeja’l al pas de Validació en bases de dades.

Paràmetres del cos

string
predeterminat:"CHN"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de base de dades.Exemple: CHN
string
predeterminat:"chn_passport_verification"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: chn_passport_verification
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"王新伟"
requerit
Nom legal complet que cal validar.Exemple: 王新伟
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"11010519900101003X"
requerit
Número d’identitat nacional per a aquest servei.Exemple: 11010519900101003X
string
predeterminat:"SAMPLE-PASS-12345"
requerit
Número de passaport.Exemple: SAMPLE-PASS-12345
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les comprovacions independents al mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • La data de naixement ha de coincidir amb la data de naixement codificada al número d’identitat nacional xinès (dígits 7 a 14 d’un número de 18 caràcters, 7 a 12 d’un número antic de 15 dígits)
  • date_of_birth ha de coincidir amb la data de naixement codificada a national_id; la font rebutja la sol·licitud directament quan les dues dades no coincideixen, de manera que una discrepància es refusa abans de la consulta i no es cobra.
  • national_id ha de coincidir amb (?:\d{15}|\d{17}[\dXx]).
  • Es valida el caràcter de verificació final de la targeta d’identitat de residents xinesa.
  • full_name ha de ser el nom original en escriptura xinesa tal com apareix al registre o al document. No enviïs la transliteració llatina per a les comprovacions de bases de dades de la Xina.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a chn_passport_verification documenta actualment aquesta estructura normalitzada:
  • date_of_birth
  • identification_number

Preus i SLA

Les consultes de Verificació de passaports de la Xina només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $1.67 USD.
  • Facturació: per consulta satisfactòria. No se’t cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típic < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font subjacent varia segons el país i el conjunt de dades.

Continuar llegint

Darrera modificació el 7 de novembre del 2026