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

Покрытие

  • Покрытие: ~ 100%
  • Страна: Финляндия
  • ID сервиса: fin_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%
  • Цена: $3.50 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как неприменимая: база данных не запрашивается, и с вас не взимается плата. Для некоторых стран это составляет значительную долю реальных пользователей. Чтобы охватить их, также получайте идентификатор из ответа на анкету, из поля извлечения Document AI или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге проверки по базам данных.

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

string
по умолчанию:"FIN"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: FIN
string
по умолчанию:"fin_national_id"
обязательно
Массив, содержащий ID этого сервиса. Указание сервиса ограничивает запрос этой конкретной базой данных.Пример: fin_national_id
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"John"
обязательно
Имя, которое нужно проверить.Пример: John
string
по умолчанию:"Doe"
обязательно
Фамилия, которую нужно проверить.Пример: Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"010190-123A"
обязательно
Национальный идентификационный номер для этого сервиса.Пример: 010190-123A
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}[-+A]\d{3}[0-9A-Z]|\d{6}\d{3}[0-9A-Z]).
  • Для сервисов, работающих с адресом, по возможности передавайте структурированные поля адреса вместо одной строки address.
  • address.street_1: адрес улицы, включая номер дома и тип улицы.
  • address.street_2: квартира, офис, корпус, этаж или дополнительная строка адреса. Передавайте её, только если она у вас есть.
  • address.city: город, пригород, район, населённый пункт или квартал.
  • address.region: штат, провинция, регион или город.
  • address.postal_code: почтовый индекс.
  • Сервисы баз данных, работающие с адресом, требуют как минимум адрес улицы и почтовый индекс. Запросы, отклонённые до обращения к источнику, не тарифицируются.

Как вызвать API

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

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

Цены и SLA

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

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

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