Перейти к основному содержанию
POST
Возвращает все должности директоров, зарегистрированные в CIPC, которые занимает физическое лицо из ЮАР. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить переданные данные с авторитетным источником и получить нормализованные результаты сопоставления.

Покрытие

  • Покрытие: -
  • Страна: ЮАР
  • ID сервиса: zaf_person_directorships
  • Домен данных: Государственные данные
  • Категория: CompanyRegister

Входные данные

  • Обязательные поля: national_id
  • Необязательные поля: vendor_data
  • Согласие: не требуется
  • Доступность в сценарии: доступно в сценарии
  • Покрытие: -
  • Цена: $1.45 за успешный запрос

Параметры тела запроса

string
по умолчанию:"ZAF"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: ZAF
string
по умолчанию:"zaf_person_directorships"
обязательно
Массив, содержащий ID этого сервиса. Закрепление сервиса ограничивает запрос именно этой базой данных.Пример: zaf_person_directorships
string
по умолчанию:"SAMPLE-NID-12345"
обязательно
Национальный идентификационный номер для этого сервиса.Пример: SAMPLE-NID-12345
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого человека в вашей системе, например внутренний ID пользователя. Didit использует его, чтобы связать отдельные проверки с одним и тем же конечным пользователем и уменьшить количество ложных срабатываний при обнаружении дубликатов.Пример: user-1234

Правила ввода и примечания по валидации

  • Передавайте перечисленные выше поля точно так, как они были получены от пользователя или из документа.
  • Didit проверяет обязательные поля до обращения к базе данных. Запросы, отклонённые до поиска в источнике, не тарифицируются.

Как вызвать

Возвращаемые данные

Точный набор полей, которые попадают в source_data, зависит от того, что возвращает реестр. Сгенерированный пример для zaf_person_directorships сейчас описывает такую нормализованную структуру:
  • directorships
  • identification_number

Цены и SLA

Запросы по поиску директорских должностей физических лиц в ЮАР оплачиваются только тогда, когда Didit получает окончательный результат от источника валидации.
  • Цена за вызов: $1.45 USD.
  • Биллинг: за успешный запрос. Плата не взимается, если реестр недоступен, если не заполнены обязательные поля или если запрос отклонён до обращения к источнику.
  • Задержка: типичное p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность внешнего источника зависит от страны и набора данных.

Продолжите чтение

Последнее изменение 7 ноября 2026 г.