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

Покрытие

  • Покрытие: ~ 85%
  • Страна: США
  • ID сервиса: usa_states_financial_services
  • Область данных: Финансы
  • Категория: FinancialServices

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

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

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

string
по умолчанию:"USA"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса баз данных.Пример: USA
string
по умолчанию:"usa_states_financial_services"
обязательно
Массив, содержащий идентификатор этого сервиса. Фиксация сервиса ограничивает запрос этой конкретной базой данных.Пример: usa_states_financial_services
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
Номер телефона в международном формате.Пример: +15550101000
string
Значение ssn, требуемое этим сервисом баз данных.Пример: 123456789
string
Адрес электронной почты.Пример: john.doe@example.com
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний из-за обнаружения дубликатов.Пример: user-1234

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

  • address необязателен для этого сервиса. Вы можете передать одну полную строку address, и Didit разобьёт её на структурированные элементы адреса, когда это возможно, или же вы можете явно передать структурированные поля.
  • Номер социального страхования США или ITIN: полные 9 цифр (дефисы необязательны) или только последние 4 цифры
  • ssn должен соответствовать шаблону (?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4}).
  • Для ssn передавайте либо полный 9-значный номер SSN/ITIN (дефисы необязательны), либо только его последние 4 цифры.
  • Этот сервис требует first_name, last_name и date_of_birth, что уже соответствует минимальному требованию источника: имя плюс ещё одно идентификационное поле. Необязательные поля (ssn, address, phone, email) дополнительно повышают точность сопоставления.
  • Для адресных сервисов по возможности передавайте структурированные поля адреса вместо одной строки address.
  • address.street_1 - это адрес улицы, включая номер дома и тип улицы.
  • address.street_2 - это квартира, помещение, корпус, этаж или дополнительная строка адреса. Передавайте её, только если она у вас есть.
  • address.city - это город, пригород, район, населённый пункт или микрорайон.
  • address.region - это штат, провинция, регион или небольшой населённый пункт.
  • address.postal_code - это почтовый индекс.
  • Для адресных сервисов баз данных обязательны как минимум адрес улицы и почтовый индекс; запросы, отклонённые до обращения к источнику, не тарифицируются.

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

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

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

Цены и SLA

Запросы United States Financial Services для United States of America тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за вызов: $0.20 USD.
  • Биллинг: за каждый успешный запрос. Плата не взимается, если реестр недоступен, если не заполнены обязательные поля или если запрос отклонён до его передачи источнику.
  • Задержка: типичное значение p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность нижестоящих источников данных зависит от страны и набора данных.

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

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