Проверка электронной почты: API, OTP и оценка риска

API проверки электронной почты предоставляет двухэтапный процесс: отправка одноразового кода на адрес электронной почты, затем проверка кода, который вводит пользователь. Система также выполняет оценку рисков, включая наличие адреса в утечках данных, определение провайдеров одноразовой почты и проверку доставляемости.

Эндпоинты

Отправить код по электронной почте

POST /v3/email/send/ — Отправка одноразового кода подтверждения на адрес электронной почты.

Проверить код из письма

POST /v3/email/check/ — Проверка кода и получение данных о риске для электронной почты.

Оценить риск электронной почты

POST /v3/email/risk/ — Оценка доставляемости, утечек данных и риска одноразовой почты без отправки кода.

Как это работает

Вызовите Отправить код по электронной почте, указав целевой адрес электронной почты
Пользователь получает 6-значный код (действителен 5 минут)
Вызовите Проверить код из письма, передав адрес электронной почты и код
Получите результат проверки и сигналы риска (наличие в утечках данных, провайдер одноразовой почты, доставляемость)

По умолчанию отдельные письма с одноразовыми кодами отправляются с брендингом Didit. Чтобы использовать отправителя и брендинг White label, настроенные для вашего приложения, для конкретной сессии отдельной проверки электронной почты, передайте options.use_white_label_customization: true в POST /v3/email/send/. По умолчанию значение false.

Сигналы риска

Ответ на проверку включает:

Сигнал	Описание
`is_breached`	Адрес электронной почты найден в известных утечках данных
`is_disposable`	Провайдер временной или одноразовой электронной почты
`is_undeliverable`	Адрес не принимает почту

Полную структуру ответа см. в разделе Отчёт о проверке электронной почты.

​Эндпоинты