REST API проверки почты
Один GET-запрос — вердикт по адресу: существует ли ящик, принимает ли домен почту, не одноразовый ли это ящик и не спам-ловушка. Письмо получателю не отправляется.
Быстрый старт
Начните использовать API проверки почты за три шага
Изучите эндпоинт
В Swagger ниже доступен GET /api/emailvalidation
с параметром email, примерами и кодами ответов.
Протестируйте
Выполните запрос прямо из Swagger. Демо-ключ
ak_sandbox_demo_mockdata_v1 вернёт пример-заглушку без списания.
Интегрируйте
Встройте проверку в форму регистрации, чистку базы рассылки или скоринг лидов.
Возможности API
Что делает API проверки почты удобным для интеграции
REST + JSON
Один GET-запрос, ответ в JSON без лишних слоёв.
Проверка вживую
Обращение к почтовому серверу домена, а не догадка по маске.
7 статусов
Вердикт status плюс уточняющий код subStatus.
Мусорные адреса
Одноразовые ящики, спам-ловушки, жалобщики и ролевые адреса.
Подсказка опечатки
Поле didYouMean исправляет домен: gmial.com → gmail.com.
Контекст домена
MX-запись, catch-all, возраст домена и почтовая платформа.
Swagger
OpenAPI спецификация и примеры запросов.
Без персональных данных
Имя, фамилия и пол владельца ящика не собираются и не возвращаются.
Платите только за результат
Если почтовый сервер домена не дал ответа (greylisting, таймаут), запрос
вернёт unknown и НЕ будет тарифицирован. Некорректный адрес
отклоняется до внешней проверки.
Swagger документация API
Откройте спецификацию OpenAPI, чтобы проверить запросы и ответы API проверки почты.
Почему выбирают наш API
Преимущества REST API проверки почты для интеграции
Простая интеграция
Один GET-эндпоинт и один параметр. Подключается любым HTTP-клиентом без SDK.
Честная тарификация
Неудавшаяся проверка (unknown) и некорректный адрес не тарифицируются.
Кэш повторных проверок
Повтор по тому же адресу в течение 12 часов отвечает мгновенно и не нагружает почтовый сервер домена.
Письмо не отправляется
Проверка ведёт диалог с почтовым сервером, но не доставляет сообщение — владелец ящика ничего не получает.
Значения status
Как читать вердикт и что делать с адресом
| Значение | Что означает | Отправлять? |
|---|---|---|
valid | Ящик существует и принимает почту. | Да |
invalid | Ящика нет либо домен не принимает почту. Письмо отскочит. | Нет |
catch-all | Домен отвечает «валидно» на любой адрес — проверить конкретный ящик невозможно. | С осторожностью |
unknown | Сервер домена не дал ответа (greylisting, таймаут, анти-спам). Не тарифицируется. | Повторить позже |
spamtrap | Адрес-ловушка для спамеров. | Категорически нет |
abuse | Владелец ранее жаловался на спам. | Нет |
do_not_mail | Ролевой адрес, одноразовый ящик, токсичный домен или глобальный стоп-лист. | Нет |
Причину вердикта уточняет поле subStatus:
mailbox_not_found, disposable, role_based,
greylisted, possible_trap и другие.
Готовы подключить проверку почты?
Используйте API для чистки базы рассылки и проверки адресов при регистрации или откройте GUI для ручной проверки.