Zum Hauptinhalt springen
POST
Gibt alle bei CIPC registrierten Direktorenämter einer natürlichen Person aus Südafrika zurück. 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 können.

Abdeckung

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

Eingaben

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

Body-Parameter

string
Standard:"ZAF"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: ZAF
string
Standard:"zaf_person_directorships"
erforderlich
Array mit dieser Dienst-ID. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: zaf_person_directorships
string
Standard:"SAMPLE-NID-12345"
erforderlich
Nationale Ausweisnummer 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 Störungen durch die 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 Pflichtfelder, bevor die Datenbank aufgerufen 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 ausgegeben werden, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für zaf_person_directorships dokumentiert derzeit diese normalisierte Struktur:
  • directorships
  • identification_number

Preise und SLAs

Abfragen der Suche nach Direktorenämtern in Südafrika werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $1.45 USD.
  • Abrechnung: pro erfolgreiche Abfrage. Sie werden nicht 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