Saltar al contingut principal
POST
Verifica les dades d’entrada 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 autoritativa i rebre resultats de coincidència normalitzats.

Cobertura

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

Entrades

  • Entrades obligatòries: first_name, last_name, first_partner_name, last_partner_name, marriage_certificate_number, birth_registration_number, birth_registration_state, birth_registration_date
  • Entrades opcionals: vendor_data
  • Consentiment: Obligatori
  • Disponibilitat en un flux de treball: Disponible en un flux de treball amb mapatge de camps
  • Cobertura: 100%*
  • Preu: $0.75 per consulta satisfactòria
En un flux de treball, first_partner_name, last_partner_name, birth_registration_state i birth_registration_date no apareixen impresos en un document d’identitat, de manera que cap pas no els produeix per si sol. Recull-los 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 mapa cadascun en el pas de Validació en bases de dades. Mentre no estiguin mapats, l’editor de flux de treball mostra aquest servei desactivat i indica quina entrada falta. En executar-se, una entrada que falta fa que la comprovació s’omet abans de fer cap consulta, de manera que no se’t cobra mai una consulta a una base de dades que no s’ha pogut fer.

Paràmetres del cos

string
predeterminat:"AUS"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: AUS
string
predeterminat:"aus_marriage_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_marriage_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:"Jamie"
requerit
Valor de first_partner_name que requereix aquest servei de base de dades.Exemple: Jamie
string
predeterminat:"Example"
requerit
Valor de last_partner_name que requereix aquest servei de base de dades.Exemple: Example
string
predeterminat:"SAMPLE-MARRIAGE-12345"
requerit
Valor de marriage_certificate_number que requereix aquest servei de base de dades.Exemple: SAMPLE-MARRIAGE-12345
string
predeterminat:"SAMPLE-BIRTH-12345"
requerit
Valor de birth_registration_number que requereix aquest servei de base de dades.Exemple: SAMPLE-BIRTH-12345
string
predeterminat:"Sample State"
requerit
Valor de birth_registration_state que requereix aquest servei de base de dades.Exemple: Sample State
string
predeterminat:"1990-01-01"
requerit
Valor de birth_registration_date que requereix aquest servei de base de dades.Exemple: 1990-01-01
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 cridar la base de dades. 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 aus_marriage_certificate documenta actualment aquesta estructura normalitzada:
  • first_name
  • identification_number
  • last_name

Preus i SLAs

Les consultes de Australia - DVS – Marriage Certificate només es cobren 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 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 de dades varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026