Vai al contenuto principale
POST
Conferma che una persona fisica sudafricana è il proprietario registrato di un determinato veicolo tramite il registro dei veicoli NATIS. 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_vehicle_ownership
  • Dominio dei dati: Governo
  • Categoria: Altro

Input

  • Input obbligatori: national_id, vehicle_register_number, vehicle_licence_plate, vin
  • Input facoltativi: vendor_data
  • Consenso: non richiesto
  • Disponibilità nel workflow: disponibile nel workflow con mappatura dei campi
  • Copertura: —
  • Prezzo: $3.36 per query riuscita
In un workflow, vehicle_register_number, vehicle_licence_plate e vin non sono stampati su un documento d’identità, quindi nessun passaggio li produce autonomamente. Raccoglili da una risposta a un questionario, da un campo di estrazione di Document AI oppure da un valore che invii quando crei la sessione, e mappa ciascuno nel passaggio Validazione su database. Finché non sono mappati, l’editor del workflow mostra questo servizio disabilitato e indica l’input mancante; in fase di esecuzione un input mancante significa che il controllo viene saltato prima di qualsiasi query, quindi non ti viene mai addebitato un database che non si sarebbe potuto interrogare.

Parametri del corpo

string
predefinito:"ZAF"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: ZAF
string
predefinito:"zaf_vehicle_ownership"
obbligatorio
Array che contiene l’ID di questo servizio. Fissare il servizio mantiene la richiesta limitata a questo specifico database.Esempio: zaf_vehicle_ownership
string
predefinito:"SAMPLE-NID-12345"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio: SAMPLE-NID-12345
string
predefinito:"VRN123456"
obbligatorio
Valore di vehicle_register_number richiesto da questo servizio di database.Esempio: VRN123456
string
predefinito:"ABC123GP"
obbligatorio
Valore di vehicle_licence_plate richiesto da questo servizio di database.Esempio: ABC123GP
string
predefinito:"1HGCM82633A004352"
obbligatorio
Valore di vin richiesto da questo servizio di database.Esempio: 1HGCM82633A004352
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 dei rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Invia i campi sopra elencati esattamente come acquisiti 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 chiamarlo

Dati restituiti

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

Prezzi e SLA

Sudafrica - le query di Verifica della proprietà del veicolo vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $3.36 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 < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026