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

Покрытие

  • Покрытие: > 10%
  • Страна: Новая Зеландия
  • ID сервиса: nzl_new_zealand_citizenship
  • Домен данных: Идентификация
  • Категория: Гражданство

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

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

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

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

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

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

Как вызвать

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

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

Цены и SLA

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

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

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