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"
}
}
]
}
🇿🇦 Südafrika
Fahrzeughalter-Verifizierung Südafrika API
Fahrzeughalter in Südafrika über offizielle Datenbanken prüfen – mit Didit. Ab $3.36 pro Abfrage, ohne Vertrag, ohne Mindestabnahme.
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"
}
}
]
}
Bestätigt, dass eine Person aus Südafrika der eingetragene Eigentümer eines bestimmten Fahrzeugs ist, und zwar über das NATIS-Fahrzeugregister. Didit stellt diesen Dienst über
POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Trefferergebnisse erhalten.
Abdeckung
- Abdeckung: —
- Land: Südafrika
- Service-ID:
zaf_vehicle_ownership - Datenbereich: Behörden
- Kategorie: Sonstiges
Eingaben
| Feld | Erforderlich | Beispiel |
|---|---|---|
national_id | Ja | SAMPLE-NID-12345 |
vehicle_register_number | Ja | VRN123456 |
vehicle_licence_plate | Ja | ABC123GP |
vin | Ja | 1HGCM82633A004352 |
vendor_data | Nein | user-1234 |
- Erforderliche Eingaben:
national_id,vehicle_register_number,vehicle_licence_plate,vin - Optionale Eingaben:
vendor_data - Einwilligung: Nicht erforderlich
- Verfügbarkeit im Workflow: Im Workflow mit Feldzuordnung verfügbar
- Abdeckung: —
- Preis: $3.36 pro erfolgreicher Abfrage
vehicle_register_number, vehicle_licence_plate und vin nicht auf einem Ausweisdokument aufgedruckt, daher erzeugt kein Schritt diese Werte allein. Erfassen Sie sie über eine Antwort auf einen Fragebogen, über ein Extraktionsfeld von Document AI oder über einen Wert, den Sie beim Erstellen der Sitzung übergeben. Ordnen Sie jeden dieser Werte dem Schritt Datenbankvalidierung zu. Solange die Werte nicht zugeordnet sind, zeigt der Workflow-Editor diesen Dienst als deaktiviert an und nennt die fehlende Eingabe. Fehlt zur Laufzeit eine Eingabe, wird die Prüfung vor einer Abfrage übersprungen. Ihnen wird also nie eine Datenbankabfrage in Rechnung gestellt, die nicht durchgeführt werden konnte.
Body-Parameter
string
Standard:"ZAF"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel:
ZAFstring
Standard:"zaf_vehicle_ownership"
erforderlich
Array mit der ID dieses Dienstes. Wenn Sie den Dienst festlegen, bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel:
zaf_vehicle_ownershipstring
Standard:"SAMPLE-NID-12345"
erforderlich
Nationale Identifikationsnummer für diesen Dienst.Beispiel:
SAMPLE-NID-12345string
Standard:"VRN123456"
erforderlich
Für diesen Datenbankdienst erforderlicher Wert
vehicle_register_number.Beispiel: VRN123456string
Standard:"ABC123GP"
erforderlich
Für diesen Datenbankdienst erforderlicher Wert
vehicle_licence_plate.Beispiel: ABC123GPstring
Standard:"1HGCM82633A004352"
erforderlich
Für diesen Datenbankdienst erforderlicher Wert
vin.Beispiel: 1HGCM82633A004352string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, zum Beispiel Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Störmeldungen bei der Duplikaterkennung zu reduzieren.Beispiel:
user-1234Eingaberegeln und Validierungshinweise
- Senden Sie die oben aufgeführten Felder genau so, wie sie vom Benutzer oder aus dem Dokument erfasst wurden.
- Didit prüft Pflichtfelder, bevor die Datenbank aufgerufen wird. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.
So rufen Sie den Dienst auf
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"
Jeder erfolgreiche Aufruf liefert HTTP 200 zurück. Das Feld outcome_code zeigt an, was tatsächlich passiert ist. Es unterscheidet zum Beispiel eine echte biometrische Nichtübereinstimmung (BIOMETRIC_NO_MATCH) von einem Selfie, das nicht gelesen werden konnte (BIOMETRIC_IMAGE_UNUSABLE). Der angezeigte status ist der Standardstatus der Funktion. Ihre konfigurierten Aktionen für Partial Match / No Match können ihn überschreiben.MATCH – Das Register hat die Identität bestätigt, und jedes geprüfte Feld stimmte überein.{
"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 – Das Register hat für die übermittelten Daten keine Übereinstimmung zurückgegeben.{
"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"
}
}
]
}
Rückgabedaten
Welche Felder genau insource_data ausgegeben werden, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für zaf_vehicle_ownership dokumentiert derzeit diese normalisierte Struktur:
identification_number
Preise und SLAs
Abfragen zur Fahrzeughalter-Verifizierung in Südafrika werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.- Preis pro Aufruf: $3.36 USD.
- Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
- Latenz: typischer p95-Wert unter 2 s.
- Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.
Weiterlesen
Zuletzt geändert am 7. November 2026