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

Покрытие

  • Покрытие: 50+ рынков
  • Страна: Глобальная
  • Service ID: glb_identity_enrichment
  • Домен данных: Идентификация
  • Категория: IdentityEnrichment

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

  • Обязательные входные данные: нет
  • Необязательные входные данные: email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Согласие: обязательно
  • Доступность в сценарии: только в отдельном API
  • Покрытие: 50+ рынков
  • Цена: $0.20 за успешный запрос
Этот сервис не предлагается как шаг проверки по базам данных внутри сценария. Это ограничивает место, где выполняется проверка, но не то, какие данные вы можете передать: вызывайте его через отдельный API, где вы передаёте входные данные напрямую.

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

string
по умолчанию:"GLB"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса проверки по базе данных.Пример: GLB
string
по умолчанию:"glb_identity_enrichment"
обязательно
Массив, содержащий ID этого сервиса. Закрепление сервиса ограничивает запрос этой конкретной базой данных.Пример: glb_identity_enrichment
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"john.doe@example.com"
Адрес электронной почты.Пример: john.doe@example.com
string
по умолчанию:"+15550101000"
Номер телефона в международном формате.Пример: +15550101000
string
по умолчанию:"John"
Имя, которое нужно проверить.Пример: John
string
по умолчанию:"Doe"
Фамилия, которую нужно проверить.Пример: Doe
string
Полное официальное имя, которое нужно проверить.Пример: John Doe
string
по умолчанию:"US"
Необязательная страна проживания в формате ISO 3166-1 alpha-2. Используется только для уточнения поиска по идентификационным данным.Пример: US
string
по умолчанию:"user-1234"
Ваш постоянный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

  • Передайте хотя бы один из параметров email или phone: они являются ключами поиска. Запрос без них не может выполнить поиск для обогащения и отклоняется до поиска в источнике (без оплаты).
  • Добавляйте имя, когда оно у вас есть: источник сверяет результаты поиска с ним. Передавайте first_name и last_name: именно эти поля сравнивает карта validation в ответе. Запрос, в котором передан только full_name, всё равно оценивается источником, но возвращается с пустой картой validation и значением null для верхнеуровневого match_type.
  • country_of_residence - это код ISO 3166-1 alpha-2, который используется для уточнения поиска.
  • Каждый завершённый поиск оплачивается, включая поиск, который не нашёл ни одного лица (persons_found: 0). Бесплатен только запрос, отклонённый до поиска, то есть запрос без email и phone.

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

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

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

Цены и SLA

Запросы Global - Identity Enrichment тарифицируются, только если Didit получает окончательный результат от источника валидации.
  • Цена за вызов: $0.20 USD.
  • Биллинг: за успешный запрос. Оплата не списывается, если реестр недоступен, если не заполнены обязательные поля или если запрос отклонён до того, как попал в источник.
  • Задержка: типичный p95 менее 2 с.
  • Доступность: 99.9% в квартал со стороны Didit. Доступность источников зависит от страны и набора данных.

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

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