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

Покрытие

  • Покрытие: ~ 95%
  • Страна: Бразилия
  • ID сервиса: bra_residential
  • Домен данных: Адрес
  • Категория: Жилая

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

  • Обязательные входные данные: first_name, last_name, date_of_birth, address.street_1, address.postal_code, tax_number
  • Необязательные входные данные: address.street_2, address.city, address.region, vendor_data
  • Согласие: Не требуется
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: ~ 95%
  • Цена: $0.59 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка отмечается как не применимо: база данных не запрашивается, и с вас не взимается плата. Для некоторых стран такая ситуация касается значительной доли реальных пользователей. Чтобы охватить таких пользователей, также получайте идентификатор из ответа в Анкетах, из поля извлечения Document AI или из значения, которое вы передаёте при создании сессии, и сопоставляйте его на шаге проверки по базам данных.

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

string
по умолчанию:"BRA"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: BRA
string
по умолчанию:"bra_residential"
обязательно
Массив, содержащий этот ID сервиса. Закрепление сервиса ограничивает запрос именно этой базой данных.Пример: bra_residential
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
по умолчанию:"11111111111"
обязательно
Налоговый или фискальный идентификационный номер.Пример: 11111111111
string
по умолчанию:"user-1234"
Ваш постоянный идентификатор пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

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

Как вызвать API

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

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

Цены и SLA

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

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

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