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

Покрытие

  • Покрытие: ~ 75%
  • Страна: Испания
  • ID сервиса: esp_dni
  • Домен данных: Идентификация
  • Категория: NationalIDRegistry

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

  • Обязательные поля: first_name, last_name, date_of_birth, address.street_1, address.postal_code
  • Необязательные поля: national_id, phone, address.street_2, address.city, address.region, vendor_data
  • Согласие: Требуется
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: ~ 75%
  • Цена: $2.10 за успешный запрос

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

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

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

  • Для сервисов, работающих с адресами, по возможности отправляйте структурированные поля адреса вместо одной строки address.
  • address.street_1: улица, включая номер дома и тип улицы.
  • address.street_2: квартира, блок, корпус, этаж или дополнительная строка адреса. Отправляйте её, только если она у вас есть.
  • address.city: город, пригород, район, населённый пункт или микрорайон.
  • address.region: область, провинция, регион или посёлок.
  • address.postal_code: почтовый индекс.
  • Сервисы баз данных, работающие с адресами, требуют как минимум улицу и почтовый индекс; запросы, отклонённые до обращения к источнику, не тарифицируются.

Как вызвать

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

Набор полей в source_data зависит от того, что возвращает реестр. В примере для esp_dni сейчас описана такая нормализованная структура:
  • address_match_score
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Цены и SLA

Проверки DNI/NIE в Испании тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за вызов: $2.10 USD.
  • Тарификация: за каждый успешный запрос. Плата не взимается, если реестр недоступен, если не хватает обязательных полей или если запрос отклонён до того, как попал в источник.
  • Задержка: типичный p95 менее 2 с.
  • Доступность: 99.9% за квартал со стороны Didit. Доступность нижестоящих источников зависит от страны и набора данных.

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

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