Zum Hauptinhalt springen
POST
Prüft die Eingabedaten mit dem Verifizierungsdienst der NZTA. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten.

Abdeckung

  • Abdeckung: 100%*
  • Land: Neuseeland
  • Service-ID: nzl_zealand_drivers_licence
  • Datenbereich: Dokument
  • Kategorie: DriverLicence

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, driver_license_number, driver_license_version
  • Optionale Eingaben: vendor_data
  • Einwilligung: erforderlich
  • Verfügbarkeit im Workflow: im Workflow verfügbar
  • Abdeckung: 100%*
  • Preis: $0.35 pro erfolgreiche Abfrage

Body-Parameter

string
Standard:"NZL"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: NZL
string
Standard:"nzl_zealand_drivers_licence"
erforderlich
Array mit dieser Service-ID. Durch die Festlegung des Services bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: nzl_zealand_drivers_licence
Ausdrückliche Einwilligung des Endbenutzers für diesen Service.Beispiel: true
string
Standard:"John"
erforderlich
Zu prüfender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu prüfender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"SAMPLE-DL-12345"
erforderlich
Führerscheinnummer.Beispiel: SAMPLE-DL-12345
string
Standard:"1"
erforderlich
Vom Datenbankdienst geforderter Wert für driver_license_version.Beispiel: 1
string
Standard:"user-1234"
Ihre dauerhafte Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und unnötige Dubletten-Meldungen zu reduzieren.Beispiel: user-1234

Regeln für Eingaben und Validierungshinweise

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

So rufen Sie den Dienst auf

Rückgabedaten

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

Preise und SLAs

Abfragen zum neuseeländischen Führerschein (NZTA) werden nur dann abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.35 USD.
  • Abrechnung: pro erfolgreiche 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