curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 Sudafrica
Sudafrica - Verifica della proprietà del veicolo API
Verifica della proprietà del veicolo in Sudafrica tramite database ufficiale con Didit. Da $3.36 per chiamata, senza contratti né minimi.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
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
| Campo | Obbligatorio | Esempio |
|---|---|---|
national_id | Sì | SAMPLE-NID-12345 |
vehicle_register_number | Sì | VRN123456 |
vehicle_licence_plate | Sì | ABC123GP |
vin | Sì | 1HGCM82633A004352 |
vendor_data | No | user-1234 |
- 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
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:
ZAFstring
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_ownershipstring
predefinito:"SAMPLE-NID-12345"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio:
SAMPLE-NID-12345string
predefinito:"VRN123456"
obbligatorio
Valore di
vehicle_register_number richiesto da questo servizio di database.Esempio: VRN123456string
predefinito:"ABC123GP"
obbligatorio
Valore di
vehicle_licence_plate richiesto da questo servizio di database.Esempio: ABC123GPstring
predefinito:"1HGCM82633A004352"
obbligatorio
Valore di
vin richiesto da questo servizio di database.Esempio: 1HGCM82633A004352string
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-1234Regole 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
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
Ogni chiamata riuscita restituisce HTTP 200. Il campo outcome_code indica cosa è effettivamente accaduto, distinguendo ad esempio una reale mancata corrispondenza biometrica (BIOMETRIC_NO_MATCH) da un selfie che non è stato possibile leggere (BIOMETRIC_IMAGE_UNUSABLE). Lo status mostrato è lo stato predefinito della funzionalità; le azioni configurate per Partial Match / No Match possono sostituirlo.MATCH: il registro ha confermato l’identità e ogni campo verificato corrispondeva.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH: il registro non ha restituito alcuna corrispondenza per i dati inviati.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Dati restituiti
I campi esatti esposti insource_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