Каждый email с опечаткой — это человек, до которого вы хотели дотянуться и не дотянулись. Кто-то регистрируется как email@mai.ru, письмо с подтверждением уходит в никуда, и клиент, который сам хотел получать ваши письма, их не получает. Опечатку он, как правило, не замечает — он просто решает, что ваши письма не приходят.
CleanContact превращает такие промахи в спасённые адреса. Когда проверка возвращает Bad или Unknown, а домен похож на промах по клавишам, в ответе появляется поле suggest с адресом, который пользователь скорее всего имел в виду. Контроль остаётся у вас: вердикт не меняется, а подсказку можно показать, применить или проигнорировать.
Пример
Проверьте адрес с опечаткой как обычно:
curl -H "X-API-Key: <ваш-ключ>" \
"https://api.cleancontact.ru/validate?email=email@mai.ru"Вердикт честный — адрес действительно Bad, — но вместе с ним ответ предлагает вероятное исправление:
{
"value": "email@mai.ru",
"result": {
"status": "Bad",
"detail": "Domain has no MX records"
},
"suggest": ["email@mail.ru"]
}Что это даёт
- Ловите опечатки на входе — показывайте подсказку «Возможно, вы имели в виду email@mail.ru?» прямо в форме регистрации, до того как неверный адрес попадёт в базу.
- Возвращайте контакты, а не только отклоняйте их — вердикт Bad становится вторым шансом, а не тупиком.
- Меньше тихих потерь — меньше обращений в поддержку «не пришло письмо» и меньше клиентов, которые молча перестали вас слышать.
Подсказки строятся по курируемому списку доверенных почтовых провайдеров, поэтому вы никогда не получите ссылку на одноразовый или похожий на настоящий домен. Поле появляется только тогда, когда есть что предложить, — во всех остальных случаях ответ остаётся ровно таким же, как раньше.
Функция включена для каждого API-ключа, настраивать ничего не нужно. Если поле suggest присутствует — покажите его пользователю: обычно это именно тот адрес, который он хотел ввести.