Saltar al contingut principal
POST
Verifica les dades introduïdes amb el servei de dades oficial de la Xina. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritzada i rebre resultats de coincidència normalitzats. Format de les entrades: date_of_birth ha de coincidir amb la data de naixement codificada al número del carnet d’identitat xinès (dígits 7 a 14 d’un número de 18 caràcters, o dígits 7 a 12 d’un de 15 dígits de l’antic format); national_id és el número del carnet d’identitat de resident xinès (15 dígits o 18 caràcters amb dígit de control).

Cobertura

  • Cobertura: ~ 100%
  • País: Xina
  • ID del servei: chn_phone
  • Àmbit de dades: Telecomunicacions
  • Categoria: Telecomunicacions

Entrades

  • Entrades obligatòries: full_name, date_of_birth, national_id, phone
  • Entrades opcionals: vendor_data
  • Consentiment: Obligatori
  • Disponibilitat en un flux de treball: Disponible en un flux de treball
  • Cobertura: ~ 100%
  • Preu: $0.50 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"CHN"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de bases de dades.Exemple: CHN
string
predeterminat:"chn_phone"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades concreta.Exemple: chn_phone
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:"+15550101000"
requerit
Número de telèfon en format internacional.Exemple: +15550101000
string
predeterminat:"user-1234"
La teva referència estable d’aquest usuari, com ara l’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 del carnet d’identitat xinès (dígits 7 a 14 d’un número de 18 caràcters, o dígits 7 a 12 d’un de 15 dígits de l’antic format)
  • 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.
  • Número del carnet d’identitat de resident xinès (15 dígits o 18 caràcters amb dígit de control)
  • national_id ha de coincidir amb (?:\d{15}|\d{17}[\dXx]).
  • Es valida el caràcter de control final del carnet d’identitat de resident xinès.
  • full_name ha de ser el nom original en escriptura xinesa tal com apareix al registre o al document. No enviïs la transliteració en alfabet llatí 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_phone documenta actualment aquesta estructura normalitzada:
  • date_of_birth
  • full_name
  • identification_number

Preus i SLA

Les consultes de China Phone només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.50 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 externa varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026