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

Покрытие

  • Покрытие: > 90%
  • Страна: Соединённые Штаты
  • Идентификатор сервиса: usa_states_phone_2
  • Область данных: Телеком
  • Категория: Телеком

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

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

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

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

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

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

Как вызвать

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

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

Цены и SLA

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

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

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