Перейти к содержанию

Валидация email

Проверка корректности email адреса. Валидация формата, проверка MX-записей домена.

URL

Метод: GET

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

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

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

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

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

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

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

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

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

{
  "success": true,
  "data": {
    "valid": true,
    "email": "test@example.com",
    "format": {
      "valid": true,
      "local": "test",
      "domain": "example.com"
    },
    "mx": {
      "checked": true,
      "valid": true,
      "records": [
        "mx1.example.com",
        "mx2.example.com"
      ]
    },
    "disposable": false,
    "role": false
  }
}

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

Название Тип данных Описание
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 Рекомендация antifraud системы: ALLOW / REVIEW / DECLINE