Zum Hauptinhalt springen
POST
Prüft die übermittelten Fingerabdruckbilder gegen das Fingerabdruckregister des Department of Home Affairs. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Ergebnisse erhalten.

Abdeckung

  • Abdeckung: —
  • Land: Südafrika
  • Dienst-ID: zaf_dha_fingerprint_match
  • Datenbereich: Biometrie
  • Kategorie: Behörde

Eingaben

  • Erforderliche Eingaben: national_id, right_thumb, left_thumb
  • Optionale Eingaben: vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Nur über die eigenständige API
  • Abdeckung: —
  • Preis: $1.28 pro erfolgreicher Abfrage
Dieser Dienst fordert right_thumb und left_thumb an. Diese Werte werden von keinem Workflow-Schritt erzeugt. Deshalb ist der Dienst nur über die eigenständige API verfügbar, bei der Sie die Werte direkt übergeben.

Body-Parameter

string
Standard:"ZAF"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: ZAF
string
Standard:"zaf_dha_fingerprint_match"
erforderlich
Array mit dieser Dienst-ID. Wenn Sie den Dienst festlegen, bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: zaf_dha_fingerprint_match
Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.Beispiel: true
string
Standard:"SAMPLE-NID-12345"
erforderlich
Nationale Identitätsnummer für diesen Dienst.Beispiel: SAMPLE-NID-12345
string
Standard:"RIGHT_THUMB_TEMPLATE"
erforderlich
Vom Datenbankdienst erforderter Wert für right_thumb.Beispiel: RIGHT_THUMB_TEMPLATE
string
Standard:"LEFT_THUMB_TEMPLATE"
erforderlich
Vom Datenbankdienst erforderter Wert für left_thumb.Beispiel: LEFT_THUMB_TEMPLATE
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 Duplikatmeldungen zu verringern.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 prüft Pflichtfelder, bevor die Datenbank aufgerufen wird. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

So rufen Sie den Dienst auf

Zurückgegebene Daten

Welche genauen Felder in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für zaf_dha_fingerprint_match dokumentiert derzeit folgende normalisierte Struktur:
  • identification_number

Preise & SLAs

Abfragen von DHA Fingerprint Match in Südafrika werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $1.28 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: typischerweise p95 < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf der Seite von Didit. Die Verfügbarkeit der nachgelagerten Quellen variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026