Zum Hauptinhalt springen
POST
Überprüft einen südafrikanischen Führerschein anhand des Registers von NATIS / Department of Transport. Didit stellt diesen Service über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten.

​
Abdeckung

  • Abdeckung: —
  • Land: Südafrika
  • Service-ID: zaf_drivers_license
  • Datenbereich: Identität
  • Kategorie: DriverLicence

​
Eingaben

  • Pflichteingaben: national_id, last_name, initials, licence_number
  • Optionale Eingaben: first_name, date_of_birth, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow mit Feldzuordnung verfügbar
  • Abdeckung: —
  • Preis: $0.80 pro erfolgreicher Abfrage
Im Workflow sind initials und licence_number nicht auf einem Ausweisdokument aufgedruckt, daher erzeugt kein Schritt diese Werte allein. Erfassen Sie sie über eine Antwort aus einem Fragebogen, ein Extraktionsfeld von Document AI oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie jeden davon im Schritt Datenbankvalidierung zu. Solange sie nicht zugeordnet sind, zeigt der Workflow-Editor diesen Service als deaktiviert an und nennt die fehlende Eingabe. Zur Laufzeit wird die Prüfung bei einer fehlenden Eingabe übersprungen, bevor eine Abfrage erfolgt. Ihnen wird also nie eine Datenbankabfrage berechnet, die nicht ausgeführt werden konnte.

​
Body-Parameter

​
string
Standard:"ZAF"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankservice.Beispiel: ZAF
​
string
Standard:"zaf_drivers_license"
erforderlich
Array mit dieser Service-ID. Durch das Festlegen des Services bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: zaf_drivers_license
​
string
Standard:"SAMPLE-NID-12345"
erforderlich
Nationale Identitätsnummer für diesen Service.Beispiel: SAMPLE-NID-12345
​
string
Standard:"Doe"
erforderlich
Zu validierender Familienname.Beispiel: Doe
​
string
Standard:"JD"
erforderlich
Wert für initials, den dieser Datenbankservice voraussetzt.Beispiel: JD
​
string
Standard:"LIC123456"
erforderlich
Wert für licence_number, den dieser Datenbankservice voraussetzt.Beispiel: LIC123456
​
string
Zu validierender Vorname.Beispiel: John
​
string
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
​
string
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 unnötige Meldungen der Duplikaterkennung zu reduzieren.Beispiel: user-1234

​
Eingaberegeln und Validierungshinweise

  • Senden Sie die oben aufgeführten Felder genau so, wie sie vom Benutzer oder aus dem Dokument erfasst wurden.
  • Didit validiert Pflichtfelder, bevor die Datenbank abgefragt wird. Anfragen, die vor der Abfrage der Quelle abgelehnt werden, werden nicht berechnet.

​
So rufen Sie sie auf

​
Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für zaf_drivers_license dokumentiert derzeit diese normalisierte Struktur:
  • expiration_date
  • first_name
  • identification_number
  • last_name
  • licence_valid
  • vehicle_codes

​
Preise und SLAs

Südafrika - Führerscheinverifizierung: Abfragen werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $0.80 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nicht berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typisch p95 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.

​
Was die einzelnen Ergebnisse bedeuten

Diese Prüfung fragt das Fahrerlaubnisregister mit der von Ihnen übermittelten Führerscheinnummer ab, zusammen mit der südafrikanischen Ausweisnummer, dem Nachnamen und den Initialen. Das Ergebnis hängt davon ab, was das Register zurückgibt:
  • MATCH: Das Register hat einen Führerscheindatensatz zu dieser Führerscheinnummer zurückgegeben, und die übermittelten Angaben stimmen damit überein. source_data enthält den Datensatz: identification_number (die Führerscheinnummer), first_name und last_name, vehicle_codes (die Führerscheinklassen, z. B. EB, C1) und expiration_date (das Ablaufdatum der Führerscheinkarte).
  • INCONCLUSIVE: Das Register hat die Abfrage angenommen, aber keinen Führerscheindatensatz zurückgegeben, sodass es nichts gab, womit die übermittelten Angaben hätten verglichen werden können. source_data.licence_valid ist true, validation ist leer und match_type ist null. Über den Führerschein ist nichts bestätigt, daher wird die Prüfung zur manuellen Prüfung weitergeleitet. Das gilt auch dann, wenn ein anderer Dienst in derselben Anfrage, etwa die Prüfung der nationalen Ausweisnummer, die Person zugeordnet hat, denn das bestätigt die Person und nicht den Führerschein.
  • NO_MATCH: Das Register hat nach dem Führerschein gesucht und ihn als ungültig gemeldet (source_data.licence_valid: false). Ihre Aktion bei Nichtübereinstimmung gilt.
  • REGISTRY_ERROR: Das Register hat die Suche nicht durchgeführt, daher wurde über den Führerschein nichts festgestellt. Die Prüfung wird zur manuellen Prüfung weitergeleitet und nicht berechnet.
Was niemals zurückgegeben wird. Es gibt kein Feld für Sperrung, Annullierung, Entzug, Vermerke oder Punkte wegen Verkehrsverstößen. Deshalb darf selbst ein MATCH Ihren Nutzern gegenüber nicht als „der Führerschein ist gültig und ohne Beanstandungen“ formuliert werden. expiration_date ist, sofern das Register es zurückgibt, die einzige Information, die dem Status nahekommt. Vergleichen Sie sie mit dem Datum der Sitzung, um zu entscheiden, ob der Führerschein abgelaufen ist, und behandeln Sie dies als eigene Regel und nicht als Teil des Abgleichergebnisses. Wenn Sie dies in Ihren Allgemeinen Geschäftsbedingungen darlegen müssen, formulieren Sie es so: Didit prüft die Führerscheindaten gegen das nationale Register und, wenn das Register einen Führerscheindatensatz zurückgibt, dessen Klassen und Ablaufdatum. Didit bestätigt damit nicht, dass die Inhaberin oder der Inhaber heute zum Führen eines Kraftfahrzeugs berechtigt ist.

​
Weiterlesen

Zuletzt geändert am 7. November 2026