Saltar al contingut principal
POST
Verifica les dades d’entrada amb el Document Verification Service (DVS). Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: 100%*
  • País: Austràlia
  • ID del servei: aus_change_of_name_certificate
  • Àmbit de dades: Identitat
  • Categoria: CivilRegistry

Entrades

  • Entrades obligatòries: first_name, last_name, date_of_birth, change_of_name_certificate_number
  • Entrades opcionals: vendor_data
  • Consentiment: obligatori
  • Disponibilitat al flux de treball: disponible al flux de treball amb mapatge de camps
  • Cobertura: 100%*
  • Preu: $0.75 per consulta satisfactòria
En un flux de treball, change_of_name_certificate_number no s’imprimeix en cap document d’identitat, de manera que cap pas no el genera per si sol. Recull-lo d’una resposta a un qüestionari, d’un camp extret de Document AI o d’un valor que envies en crear la sessió, i mapa’l al pas de Validació en bases de dades. Fins que no es mapegi, l’editor de flux de treball mostra aquest servei desactivat i indica l’entrada que falta. En executar-se, una entrada que falta vol dir que la comprovació s’omet abans de cap consulta, així que mai no et cobrem per una base de dades que no s’hagi pogut consultar.

Paràmetres del cos

string
predeterminat:"AUS"
requerit
Codi de país ISO 3166-1 alpha-3 d’aquest servei de bases de dades.Exemple: AUS
string
predeterminat:"aus_change_of_name_certificate"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: aus_change_of_name_certificate
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"John"
requerit
Nom de pila a validar.Exemple: John
string
predeterminat:"Doe"
requerit
Cognom a validar.Exemple: Doe
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"SAMPLE-CON-12345"
requerit
Valor de change_of_name_certificate_number que requereix aquest servei de bases de dades.Exemple: SAMPLE-CON-12345
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. 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ó

  • Envia els camps indicats més amunt exactament tal com s’han capturat de l’usuari o del document.
  • Didit valida els camps obligatoris abans de consultar la base de dades. Les sol·licituds rebutjades abans de la consulta a la font no es cobren.

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 aus_change_of_name_certificate documenta actualment aquesta estructura normalitzada:
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Preus i SLAs

Austràlia: les consultes del DVS sobre el certificat de canvi de nom només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.75 USD.
  • Facturació: per consulta satisfactòria. No et cobrem 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 posterior varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026