Руководства и документация
Простые объяснения для всех + техническая документация для разработчиков.
Руководства
Что такое проверка email и почему это важно
Разбираемся, что именно проверяет email-сервис и как проверка помогает уменьшить количество недоставленных писем.
Good, Bad, Unknown: как читать результаты проверки
Разбираем, что означает каждый статус и что делать с адресом дальше.
Как мы проверяем, существует ли email-адрес
Разбираем, как CleanContact проверяет адрес через SMTP, не отправляя письмо получателю.
Домены catch-all и почему они сложны
Некоторые провайдеры принимают почту на любой возможный адрес, реальный или нет. Из-за этого обычные проверки могут ошибаться. Рассказываем, как CleanContact определяет настоящий email-адрес.
Одноразовые email: как мы их определяем
Каждый день появляются новые сервисы для создания временных почтовых адресов. Мы регулярно обновляем список таких сервисов, чтобы вовремя их отсеивать из вашей базы.
Снизьте уровень отказов и защитите репутацию отправителя
Доставляемость напрямую зависит от репутации вашего домена. Проверка базы перед отправкой — самое простое и эффективное, что можно сделать, чтобы письма доходили, а не падали в спам.
Порог доставляемости и блокировка домена
Разбираем, как количество отказов и жалоб влияет на доставку писем и почему почтовый провайдер может ограничить отправку с вашего домена. В статье изложены пороговые значения, механизм блокировки и источники данных.
Нормализация email: приводим адреса к единому виду
Один адрес может быть записан по-разному. CleanContact приводит такие адреса к единому виду и возвращает его вместе с исходным адресом.
Подсказки при опечатках
CleanContact распознаёт вероятные опечатки и возвращает адрес, который пользователь скорее всего имел в виду, — готовую подсказку «возможно, вы имели в виду».
Gmail dot trick: одна почта за разными написаниями
Gmail игнорирует точки в локальной части адреса, поэтому j.ohn@gmail.com и john@gmail.com — один и тот же адрес; Яндекс считает точку и дефис одним символом. CleanContact замечает, когда за несколькими написаниями у любого из этих провайдеров скрывается один и тот же адрес.
Подозрительные адреса: как не пишут люди
Некоторые адреса вообще не набирает человек — их производит скрипт, которому на каждой регистрации нужен новый уникальный на вид адрес. CleanContact замечает нечеловеческое написание уже на первом запросе.
Humaneness: как мы определяем автоматически сгенерированные email-адреса
ivan.ivanov@mail.ru выглядит как адрес человека. fjweowenfmewjewk@mail.ru — нет. CleanContact оценивает эту разницу по шкале от 0 до 1 с помощью ML-модели, независимо от всех правиловых сигналов.
Документация
Справочник API: сервис /validate
Всё для интеграции: запрос, заголовки, форма ответа и что означает каждый код состояния.
Аутентификация и ключи API
Как работают ключи, где их создавать и как держать публичные и серверные ключи раздельно и в безопасности.
Примеры подключения: cURL, Node.js, Web и PHP
Рабочие примеры запроса к эндпоинту /validate для пяти окружений. cURL, Node.js на CommonJS, Node.js на TypeScript, JavaScript в браузере и PHP.
Пакетная проверка: как проверить целый файл адресов
Загрузите CSV или TXT в личном кабинете, убедитесь, что сервис правильно прочитал файл, запустите проверку и скачайте результат одним файлом.