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

Покрытие

  • Покрытие: ~ 100%
  • Страна: Дания
  • ID сервиса: dnk_national_id
  • Область данных: Идентификация
  • Категория: NationalIDRegistry

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

  • Обязательные поля: first_name, last_name, date_of_birth, national_id
  • Необязательные поля: address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Согласие: Не требуется
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: ~ 100%
  • Цена: $2.32 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется со статусом не применимо: база данных не запрашивается, и с вас не взимается плата. Для некоторых стран такие случаи составляют значительную долю реальных пользователей. Чтобы охватить и их, также собирайте идентификатор из ответа в анкете, из поля извлечения Document AI или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге «Проверка по базам данных».

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

string
по умолчанию:"DNK"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: DNK
string
по умолчанию:"dnk_national_id"
обязательно
Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос этой конкретной базой данных.Пример: dnk_national_id
string
по умолчанию:"John"
обязательно
Имя для проверки.Пример: John
string
по умолчанию:"Doe"
обязательно
Фамилия для проверки.Пример: Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"0101901234"
обязательно
Национальный идентификационный номер для этого сервиса.Пример: 0101901234
object
Структурированный объект адреса проживания. Используйте street_1, street_2, city, region, postal_code и country. Полная строка адреса в старом формате по-прежнему принимается, но не рекомендуется.Пример: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

  • address необязателен для этого сервиса. Можно передать одну полную строку address, и Didit разобьёт её на структурированные элементы адреса, когда это возможно, либо можно явно передать структурированные поля.
  • national_id должен соответствовать шаблону \d{6}-?\d{4}.
  • Для адресных сервисов по возможности передавайте структурированные поля адреса вместо одной строки address.
  • address.street_1 содержит адрес улицы, включая номер дома и тип улицы.
  • address.street_2 содержит квартиру, помещение, корпус, этаж или дополнительную строку адреса. Передавайте её только при наличии.
  • address.city содержит город, пригород, район, населённый пункт или микрорайон.
  • address.region содержит штат, провинцию, регион или населённый пункт.
  • address.postal_code содержит почтовый индекс.
  • Адресные сервисы баз данных требуют как минимум адрес улицы и почтовый индекс. Запросы, отклонённые до обращения к источнику, не тарифицируются.

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

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

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

Цены и SLA

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

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

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