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

Охват

  • Охват: —
  • Страна: ЮАР
  • ID сервиса: zaf_vehicle_ownership
  • Домен данных: Государственные данные
  • Категория: Прочее

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

  • Обязательные входные данные: national_id, vehicle_register_number, vehicle_licence_plate, vin
  • Необязательные входные данные: vendor_data
  • Согласие: Не требуется
  • Доступность в сценарии: Доступно в сценарии с сопоставлением полей
  • Охват: —
  • Цена: $3.36 за успешный запрос
В сценарии поля vehicle_register_number, vehicle_licence_plate и vin не указаны в документе, удостоверяющем личность, поэтому ни один шаг не формирует их сам по себе. Получайте их из ответа на анкету, из поля, извлечённого с помощью Document AI, или из значения, которое вы передаёте при создании сессии, и сопоставляйте каждое из них на шаге проверки по базам данных. Пока сопоставление не выполнено, редактор сценария показывает этот сервис как отключённый и называет отсутствующее входное значение. Во время выполнения отсутствие входного значения означает, что проверка пропускается до любого запроса, поэтому с вас не взимается плата за базу данных, которую невозможно запросить.

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

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

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

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

Как выполнить вызов

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

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

Цены и SLA

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

Читайте далее

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