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"
}
}
]
}
🇿🇦 Sud-àfrica
Verificació de propietat de vehicles a Sud-àfrica - API
Consulta la propietat de vehicles a Sud-àfrica en bases de dades oficials amb Didit. Des de $3.36 per verificació, sense contractes ni mínims.
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"
}
}
]
}
Confirma que una persona física sud-africana és la propietària registrada d’un vehicle determinat mitjançant el registre de vehicles NATIS. Didit exposa aquest servei mitjançant
POST /v3/database-validation/ perquè puguis verificar les dades enviades contra la font autoritzada i rebre resultats de coincidència normalitzats.
Cobertura
- Cobertura: —
- País: Sud-àfrica
- ID del servei:
zaf_vehicle_ownership - Domini de dades: Govern
- Categoria: Altres
Entrades
| Camp | Obligatori | Exemple |
|---|---|---|
national_id | Sí | SAMPLE-NID-12345 |
vehicle_register_number | Sí | VRN123456 |
vehicle_licence_plate | Sí | ABC123GP |
vin | Sí | 1HGCM82633A004352 |
vendor_data | No | user-1234 |
- Entrades obligatòries:
national_id,vehicle_register_number,vehicle_licence_plate,vin - Entrades opcionals:
vendor_data - Consentiment: No cal
- Disponibilitat en un flux de treball: Disponible en un flux de treball amb mapatge de camps
- Cobertura: —
- Preu: $3.36 per consulta satisfactòria
vehicle_register_number, vehicle_licence_plate i vin no apareixen impresos en cap document d’identitat, per la qual cosa cap pas els produeix per si sol. Recull-los d’una resposta del Qüestionari, d’un camp d’extracció de Document AI o d’un valor que envies en crear la sessió, i mapeja cadascun al pas de Validació en bases de dades. Mentre no estiguin mapats, l’editor de fluxos mostra aquest servei desactivat i indica l’entrada que falta; en execució, una entrada que falta fa que la comprovació s’ometi abans de cap consulta, de manera que mai no se’t factura una base de dades que no s’ha pogut consultar.
Paràmetres del cos
string
predeterminat:"ZAF"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple:
ZAFstring
predeterminat:"zaf_vehicle_ownership"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple:
zaf_vehicle_ownershipstring
predeterminat:"SAMPLE-NID-12345"
requerit
Número d’identitat nacional per a aquest servei.Exemple:
SAMPLE-NID-12345string
predeterminat:"VRN123456"
requerit
Valor de
vehicle_register_number que requereix aquest servei de base de dades.Exemple: VRN123456string
predeterminat:"ABC123GP"
requerit
Valor de
vehicle_licence_plate que requereix aquest servei de base de dades.Exemple: ABC123GPstring
predeterminat:"1HGCM82633A004352"
requerit
Valor de
vin que requereix aquest servei de base de dades.Exemple: 1HGCM82633A004352string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les comprovacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple:
user-1234Regles d’entrada i notes de validació
- Envia els camps indicats anteriorment exactament tal com s’han capturat de l’usuari o del document.
- Didit valida els camps obligatoris abans de cridar la base de dades. Les sol·licituds rebutjades abans de la consulta a la font no es facturen.
Com fer la crida
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"
Cada crida satisfactòria retorna HTTP 200. El camp outcome_code indica què ha passat realment, distingint, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status mostrat és l’estat predeterminat de la funcionalitat; les teves accions configurades per a Coincidència parcial / Sense coincidència el poden substituir.MATCH: El registre ha confirmat la identitat i tots els camps comprovats han coincidit.{
"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: El registre no ha retornat cap coincidència per a les dades enviades.{
"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"
}
}
]
}
Dades retornades
Els camps exactes que apareixen asource_data depenen del que retorni el registre. L’exemple generat per a zaf_vehicle_ownership documenta actualment aquesta estructura normalitzada:
identification_number
Preus i SLA
Les consultes de Verificació de titularitat de vehicles de Sud-àfrica només es facturen quan Didit rep un resultat concloent de la font de validació.- Preu per crida: $3.36 USD.
- Facturació: per consulta satisfactòria. No se’t cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
- Latència: p95 típic < 2 s.
- Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font de dades varia segons el país i el conjunt de dades.
Continua llegint
Darrera modificació el 7 de novembre del 2026