Vai al contenuto principale
POST
Restituisce i numeri di telefono, le email e gli indirizzi noti associati a una persona fisica sudafricana. Didit espone questo servizio tramite POST /v3/database-validation/ per permetterti di verificare i dati inviati rispetto alla fonte autorevole e di ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: —
  • Paese: Sudafrica
  • ID servizio: zaf_contactability
  • Dominio dei dati: Telecom
  • Categoria: Telecom

Input

  • Input obbligatori: national_id
  • Input facoltativi: vendor_data
  • Consenso: obbligatorio
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: —
  • Prezzo: $0.35 per query riuscita

Parametri del body

string
predefinito:"ZAF"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: ZAF
string
predefinito:"zaf_contactability"
obbligatorio
Array contenente l’ID di questo servizio. Specificare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: zaf_contactability
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:"user-1234"
Il tuo riferimento 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 dovuto ai duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Invia i campi indicati sopra esattamente come raccolti dall’utente o dal documento.
  • Didit convalida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima della ricerca nella 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_contactability documenta attualmente questa struttura normalizzata:
  • contact_email
  • contact_phone_numbers
  • date_of_birth
  • deceased
  • first_name
  • gender
  • identification_number
  • last_name
  • phone_history_count

Prezzi e SLA

Le query di South Africa - Contactability Lookup vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.35 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à delle fonti a valle varia in base al paese e al dataset.

Prosegui la lettura

Ultima modifica il 7 novembre 2026