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