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

Покрытие

  • Покрытие: 100%*
  • Страна: Новая Зеландия
  • ID сервиса: nzl_zealand_drivers_licence
  • Домен данных: Документ
  • Категория: DriverLicence

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

  • Обязательные входные данные: first_name, last_name, date_of_birth, driver_license_number, driver_license_version
  • Необязательные входные данные: vendor_data
  • Согласие: требуется
  • Доступность в сценарии: доступно в сценарии
  • Покрытие: 100%*
  • Цена: $0.35 за успешный запрос

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

string
по умолчанию:"NZL"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: NZL
string
по умолчанию:"nzl_zealand_drivers_licence"
обязательно
Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос этой конкретной базой данных.Пример: nzl_zealand_drivers_licence
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"John"
обязательно
Имя, которое нужно проверить.Пример: John
string
по умолчанию:"Doe"
обязательно
Фамилия, которую нужно проверить.Пример: Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"SAMPLE-DL-12345"
обязательно
Номер водительского удостоверения.Пример: SAMPLE-DL-12345
string
по умолчанию:"1"
обязательно
Значение driver_license_version, которое требуется этим сервисом базы данных.Пример: 1
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого человека в вашей системе, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

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

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

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

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

Цены и SLA

Запросы New Zealand Drivers Licence (NZTA) тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за вызов: $0.35 USD.
  • Тарификация: за успешный запрос. С вас не взимается плата, если реестр недоступен, если обязательные поля не заполнены или если запрос отклонён до отправки в источник.
  • Задержка: типичное значение p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность источников данных зависит от страны и набора данных.

Что почитать дальше

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