Zum Hauptinhalt springen
POST
Ruft das registrierte Lichtbild des Department of Home Affairs für eine südafrikanische Ausweisnummer ab. 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 können.

Abdeckung

  • Abdeckung: —
  • Land: Südafrika
  • Service-ID: zaf_dha_photo
  • Datenbereich: Biometrie
  • Kategorie: Behörden

Eingaben

  • Pflichteingaben: national_id
  • Optionale Eingaben: vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: —
  • Preis: $1.34 pro erfolgreiche Abfrage

Body-Parameter

string
Standard:"ZAF"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankservice.Beispiel: ZAF
string
Standard:"zaf_dha_photo"
erforderlich
Array, das diese Service-ID enthält. Das Festlegen des Services begrenzt die Anfrage auf genau diese Datenbank.Beispiel: zaf_dha_photo
Ausdrückliche Einwilligung des Endbenutzers für diesen Service.Beispiel: true
string
Standard:"SAMPLE-NID-12345"
erforderlich
Nationale Ausweisnummer für diesen Service.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 das Rauschen bei der Duplikaterkennung 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 die Pflichtfelder, bevor die Datenbank abgefragt wird. Anfragen, die vor der Abfrage der Quelle abgelehnt werden, werden nicht berechnet.

So rufen Sie es 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_dha_photo dokumentiert derzeit diese normalisierte Struktur:
  • birth_place_country_code
  • deceased
  • first_name
  • id_blocked
  • identification_number
  • last_name
  • marital_status
  • on_hanis_biometric_register
  • on_national_population_register
  • photo_base64
  • smart_card_issued
  • transaction_number

Preise & SLAs

Abfragen für South Africa - DHA Photo Retrieval werden nur dann berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $1.34 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