Saltar al contingut principal
POST
Verifica les dades d’entrada amb el número d’identitat nacional obtingut d’una agència governamental. Didit ofereix aquest servei mitjançant POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritzada i rebre resultats de coincidència normalitzats. Format d’entrada: national_id accepta el número d’identitat nacional tailandès: 13 dígits l’últim dels quals és el dígit de control mòdul 11 (pesos del 13 al 2 sobre els primers dotze dígits).

Cobertura

  • Cobertura: ~ 90%
  • País: Tailàndia
  • ID del servei: tha_national_id
  • Domini de dades: Identitat
  • Categoria: NationalIDRegistry

Entrades

  • Entrades obligatòries: first_name, last_name, date_of_birth, national_id
  • Entrades opcionals: address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Disponible al flux de treball
  • Cobertura: ~ 90%
  • Preu: $0.59 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"THA"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de base de dades.Exemple: THA
string
predeterminat:"tha_national_id"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: tha_national_id
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"John"
requerit
Nom de pila que cal validar.Exemple: John
string
predeterminat:"Doe"
requerit
Cognom que cal validar.Exemple: Doe
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"1111111111111"
requerit
Número d’identitat nacional per a aquest servei.Exemple: 1111111111111
object
Objecte d’adreça residencial estructurat. Utilitza street_1, street_2, city, region, postal_code i country. Encara s’accepta una adreça completa i heretada en una sola cadena de text, però no es recomana.Exemple: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
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 verificacions independents amb el mateix usuari final i reduir el soroll de la detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • address és opcional per a aquest servei. Pots enviar una sola cadena address completa i Didit la dividirà en elements d’adreça estructurats quan sigui possible, o pots enviar els camps estructurats explícitament.
  • Número d’identitat nacional tailandès: 13 dígits l’últim dels quals és el dígit de control mòdul 11 (pesos del 13 al 2 sobre els primers dotze dígits).
  • national_id ha de contenir només dígits; elimina espais, guions i signes de puntuació abans d’enviar la sol·licitud.
  • national_id ha de tenir exactament 13 caràcters.
  • Es valida el dígit de control del número d’identitat nacional tailandès (mòdul 11); un número que no superi la comprovació es rebutja abans de la consulta i no es cobra.
  • Per als serveis d’adreça, envia els camps d’adreça estructurats en lloc d’una sola cadena address sempre que sigui possible.
  • address.street_1 és l’adreça del carrer, incloent-hi el número i el tipus de via.
  • address.street_2 és l’apartament, la unitat, l’edifici, el pis o qualsevol línia addicional de l’adreça. Envia-la només quan la tinguis.
  • address.city és la ciutat, el barri, el districte, la localitat o el veïnat.
  • address.region és l’estat, la província, la regió, el poble o la vila.
  • address.postal_code és el codi postal.
  • Els serveis de base de dades basats en adreces requereixen almenys l’adreça del carrer i el codi postal; les sol·licituds rebutjades abans de la consulta a la font no es cobren.

Com cridar-la

Dades retornades

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

Preus i SLA

Les consultes de l’identificador nacional de Tailàndia només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per consulta: $0.59 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 habitual < 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