Vai al contenuto principale
POST
Verifica le immagini delle impronte digitali fornite rispetto al registro delle impronte del Department of Home Affairs. Didit espone questo servizio tramite POST /v3/database-validation/ in modo che tu possa verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: —
  • Paese: Sudafrica
  • ID servizio: zaf_dha_fingerprint_match
  • Dominio dei dati: Biometrico
  • Categoria: Governo

Input

  • Input obbligatori: national_id, right_thumb, left_thumb
  • Input facoltativi: vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Solo API autonoma
  • Copertura: —
  • Prezzo: $1.28 per query riuscita
Questo servizio richiede right_thumb e left_thumb, che un passaggio del workflow non produce, quindi è disponibile solo tramite l’API autonoma, dove fornisci tu i valori direttamente.

Parametri del body

string
predefinito:"ZAF"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: ZAF
string
predefinito:"zaf_dha_fingerprint_match"
obbligatorio
Array che contiene l’ID di questo servizio. Specificare il servizio limita la richiesta a questo database preciso.Esempio: zaf_dha_fingerprint_match
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"SAMPLE-NID-12345"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio: SAMPLE-NID-12345
string
predefinito:"RIGHT_THUMB_TEMPLATE"
obbligatorio
Valore di right_thumb richiesto da questo servizio di database.Esempio: RIGHT_THUMB_TEMPLATE
string
predefinito:"LEFT_THUMB_TEMPLATE"
obbligatorio
Valore di left_thumb richiesto da questo servizio di database.Esempio: LEFT_THUMB_TEMPLATE
string
predefinito:"user-1234"
Il tuo riferimento stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dei rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Invia i campi sopra elencati esattamente come raccolti dall’utente o dal documento.
  • Didit valida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima della consultazione della fonte non vengono addebitate.

Come effettuare la chiamata

Dati restituiti

I campi esatti restituiti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per zaf_dha_fingerprint_match documenta attualmente questa struttura normalizzata:
  • identification_number

Prezzi e SLA

Le query DHA Fingerprint Match per il Sudafrica vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $1.28 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico inferiore a 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia per paese e set di dati.

Continua a leggere

Ultima modifica il 7 novembre 2026