Zum Hauptinhalt springen
POST
Gibt bekannte Telefonnummern, E-Mail-Adressen und Adressen zurück, die einer natürlichen Person in Südafrika zugeordnet sind. 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: —
  • Land: Südafrika
  • Service-ID: zaf_contactability
  • Datenbereich: Telekommunikation
  • Kategorie: Telekommunikation

Eingaben

  • Pflichteingaben: national_id
  • Optionale Eingaben: vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: —
  • Preis: $0.35 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_contactability"
erforderlich
Array mit dieser Service-ID. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: zaf_contactability
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:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen derselben Endbenutzerin bzw. demselben Endbenutzer zuzuordnen und unnötige Duplikatserkennungen zu reduzieren.Beispiel: user-1234

Eingaberegeln 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 Quellenabfrage abgelehnt werden, werden nicht berechnet.

So rufen Sie es auf

Rückgabedaten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für zaf_contactability dokumentiert derzeit folgende normalisierte Struktur:
  • contact_email
  • contact_phone_numbers
  • date_of_birth
  • deceased
  • first_name
  • gender
  • identification_number
  • last_name
  • phone_history_count

Preise und SLAs

Abfragen zur Kontaktierbarkeit in Südafrika werden nur berechnet, wenn Didit ein schlüssiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.35 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Es fallen keine Kosten an, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischerweise p95 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