Vai al contenuto principale
POST
Recupera la fotografia registrata presso il Department of Home Affairs per un numero di identificazione sudafricano. Didit espone questo servizio tramite POST /v3/database-validation/ per permetterti di verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: —
  • Paese: Sudafrica
  • ID servizio: zaf_dha_photo
  • Dominio dei dati: Biometrico
  • Categoria: Governativo

Input

  • Input obbligatori: national_id
  • Input facoltativi: vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: —
  • Prezzo: $1.34 per query riuscita

Parametri del corpo

string
predefinito:"ZAF"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di validazione su database.Esempio: ZAF
string
predefinito:"zaf_dha_photo"
obbligatorio
Array contenente l’ID di questo servizio. Specificare il servizio vincola la richiesta a questo database specifico.Esempio: zaf_dha_photo
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"SAMPLE-NID-12345"
obbligatorio
Numero di identificazione nazionale per questo servizio.Esempio: SAMPLE-NID-12345
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore del rilevamento dei duplicati.Esempio: user-1234

Regole per gli input e note sulla validazione

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

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce la fonte. L’esempio generato per zaf_dha_photo documenta attualmente questa struttura normalizzata:
  • birth_place_country_code
  • deceased
  • first_name
  • id_blocked
  • identification_number
  • last_name
  • marital_status
  • on_hanis_biometric_register
  • on_national_population_register
  • photo_base64
  • smart_card_issued
  • transaction_number

Prezzi e SLA

Le query DHA Photo Retrieval per il Sudafrica vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $1.34 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando la fonte non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipica < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026