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

Покрытие

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

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

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

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

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

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

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

Как вызвать

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

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

Цены и SLA

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

Читайте также

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