Zum Hauptinhalt springen
POST
Überprüft Eingabedaten im Register des Department of Home Affairs (DHA) in Südafrika. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten können.

Abdeckung

  • Abdeckung: ~ 100%
  • Land: Südafrika
  • Service-ID: zaf_africa_national_id
  • Datendomäne: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, national_id
  • Optionale Eingaben: vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 100%
  • Preis: $1.34 pro erfolgreicher Abfrage

Body-Parameter

string
Standard:"ZAF"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: ZAF
string
Standard:"zaf_africa_national_id"
erforderlich
Array mit dieser Service-ID. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: zaf_africa_national_id
string
Standard:"John"
erforderlich
Zu validierender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu validierender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"SAMPLE-NID-12345"
erforderlich
Nationale Identifikationsnummer für diesen Dienst.Beispiel: SAMPLE-NID-12345
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Fehlalarme bei der Duplikaterkennung zu verringern.Beispiel: user-1234

Regeln für Eingaben und Validierungshinweise

  • Übermitteln 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 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_africa_national_id dokumentiert derzeit diese normalisierte Struktur:
  • first_name
  • identification_number
  • last_name
  • marital_status

Preise und SLAs

Abfragen zur Nationalen ID Südafrikas (DHA) werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Abfrage: $1.34 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 Quellen variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026