Saltar al contingut principal
POST
Verifica les dades introduïdes amb el Document Verification Service (DVS). Didit ofereix 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_citizenship_certificate
  • Domini de dades: Identitat
  • Categoria: Ciutadania

Entrades

  • Entrades obligatòries: first_name, last_name, date_of_birth, citizenship_certificate_number
  • Entrades opcionals: middle_name, vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Disponible al flux de treball amb assignació de camps
  • Cobertura: 100%*
  • Preu: $0.75 per consulta satisfactòria
En un flux de treball, citizenship_certificate_number no s’imprimeix en cap document d’identitat, de manera que cap pas no el produeix per si sol. Recull-lo d’una resposta de Qüestionari, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i assigna’l al pas de Validació en bases de dades. Fins que no s’assigni, l’editor de fluxos mostra aquest servei desactivat i indica l’entrada que falta. En executar-se, una entrada que falta fa que la comprovació s’ometi abans de cap consulta, de manera que mai no se’t factura una consulta a 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 alfa-3 per a aquest servei de base de dades.Exemple: AUS
string
predeterminat:"aus_citizenship_certificate"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: aus_citizenship_certificate
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:"SAMPLE-CERT-12345"
requerit
Valor de citizenship_certificate_number que requereix aquest servei de base de dades.Exemple: SAMPLE-CERT-12345
string
Segon nom, quan n’hi hagi.Exemple: Demo
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 enllaçar les comprovacions 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ó

  • 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 cridar la base de dades. Les sol·licituds rebutjades abans de la consulta a la font no es facturen.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni la font. L’exemple generat per a aus_citizenship_certificate documenta actualment aquesta estructura normalitzada:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • middle_name

Preus i SLA

Les consultes de DVS – Certificat de ciutadania d’Austràlia 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 se’t factura quan la font 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 les fonts subjacents varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026