Saltar al contingut principal
POST
Verifica les imatges d’empremtes dactilars proporcionades amb el registre d’empremtes del Department of Home Affairs. 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: -
  • País: Sud-àfrica
  • ID del servei: zaf_dha_fingerprint_match
  • Domini de dades: Biomètric
  • Categoria: Govern

Entrades

  • Entrades obligatòries: national_id, right_thumb, left_thumb
  • Entrades opcionals: vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Només API autònoma
  • Cobertura: -
  • Preu: $1.28 per consulta satisfactòria
Aquest servei demana right_thumb i left_thumb, que no són valors que produeixi un pas del flux de treball, de manera que només està disponible a l’API autònoma, on proporciones els valors directament.

Paràmetres del cos

string
predeterminat:"ZAF"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de bases de dades.Exemple: ZAF
string
predeterminat:"zaf_dha_fingerprint_match"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: zaf_dha_fingerprint_match
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"SAMPLE-NID-12345"
requerit
Número d’identitat nacional per a aquest servei.Exemple: SAMPLE-NID-12345
string
predeterminat:"RIGHT_THUMB_TEMPLATE"
requerit
Valor de right_thumb que requereix aquest servei de bases de dades.Exemple: RIGHT_THUMB_TEMPLATE
string
predeterminat:"LEFT_THUMB_TEMPLATE"
requerit
Valor de left_thumb que requereix aquest servei de bases de dades.Exemple: LEFT_THUMB_TEMPLATE
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 comprovacions autònomes amb el 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 zaf_dha_fingerprint_match documenta actualment aquesta estructura normalitzada:
  • identification_number

Preus i SLA

Les consultes de DHA Fingerprint Match de Sud-àfrica només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $1.28 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ípica < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font dependent varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026