Проверка email-адреса

Комплексная проверка email-адреса:

проверка формата (RFC)
проверка MX-записей
проверка существования почтового ящика
проверка disposable email
расчёт fraud risk score

Используется в антифрод-системах банков и МФО.

URL

Метод: GET

Production: https://registry.wallet.kvell.group/reg2/validation/email

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

Название	Тип данных	Обязательно	Описание
`email`	string	Да	Email-адрес
`smtp`	boolean	Нет	Проверка почты по SMTP-протоколу

Пример запроса

GET https://registry.wallet.kvell.group/reg2/validation/email?email=mail@gmail.com&smtp=true

Заголовки запроса

Название	Тип данных	Обязательно	Описание
`X-Api-Key`	string	Да	Уникальный идентификатор (UUID)

Ответ запроса

Пример ответа

200: OK

{
  "email": "test@gmail.com",
  "valid": true,
  "exists": true,
  "disposable": false,
  "freeProvider": true,
  "mxValid": true,
  "riskScore": 0.12,
  "recommendation": "ALLOW"
}

Параметры ответа

Название	Тип данных	Описание
`email`	string	Нормализованный email
`valid`	boolean	Корректный формат (RFC 5322)
`exists`	boolean	Почтовый ящик существует (SMTP)
`disposable`	boolean	Временный (disposable) сервис
`freeProvider`	boolean	Бесплатный провайдер (gmail, mail.ru и др.)
`mxValid`	boolean	Домен имеет корректные MX-записи
`riskScore`	number	Оценка риска от 0.0 до 1.0
`recommendation`	string	`ALLOW` / `REVIEW` / `DECLINE`