Как EmailCheckPro проверяет адрес email

Выполнение одной проверки

Этот раздел посвящён проверкам в реальном времени: панель SaaS и синхронные эндпоинты REST используют один сервис проверки и одинаковое значение ответа. Для очень больших списков есть асинхронный массовый вариант — он описан в конце страницы.

1. 1

   Отправьте адрес email

   Отправьте один полный адрес email, как описано в документации API.

2. 2

   Используйте service_type=email

   Продукт email проверяет, был ли адрес доставляемым — мог ли принимать почту — на момент проверки.

3. 3

   Прочитайте результат

   Прочитайте registered в том же ответе. Запустите новую проверку, когда понадобится обновлённый статус.

В каком формате отправлять email

EmailCheckPro принимает один адрес email на проверку: локальную часть, знак @ и домен — например, name@example.com. Подходит любой домен, как у личных, так и у корпоративных почтовых ящиков. Домен лишь определяет, какой маршрут используется внутри; выбирать его вам не нужно. Перед проверкой адреса очищаются от пробелов по краям и приводятся к нижнему регистру, поэтому регистр и лишние пробелы на результат не влияют.

• Отправляйте полный адрес. Отдельно локальную часть или отдельно домен проверить нельзя.
• Отображаемые имена и угловые скобки не принимаются — отправляйте сам адрес, а не "Name <name@example.com>".
• Адреса email в неверном формате отклоняются до списания; отклонённый формат — это не результат «недоставляемый».

Что означает registered?

registered — это ответ проверки email. Поле присутствует только в успешном ответе и является логическим: true означает, что адрес доставляем (может принимать почту) на момент запроса, false — что нет. Всё остальное — тайм-аут, неопределённый результат, неверный адрес — возвращается вместо этого как код ошибки, и EmailCheckPro автоматически возвращает средства за такую проверку. Поэтому отсутствие поля registered никогда не означает «недоставляемый»: это значит, что проверка не дала результата. Значение отражает момент запроса: аккаунты постоянно создаются и удаляются, поэтому обновляйте проверку перед тем, как действовать на основе старого результата, а не кэшируйте его неделями.

• registered=true означает «доставляемый»: адрес может принимать почту.
• registered=false означает «недоставляемый»: адрес не может принимать почту.
• Другие исходы обрабатывайте по коду ответа API; не выводите значение registered самостоятельно.

Используйте результат в пределах его назначения

Проверка отражает статус на момент запроса. Это не подтверждение личности и не разрешение связываться с человеком.

• Проверка не подтверждает, кому принадлежит адрес email, выполнен ли сейчас вход в аккаунт, и ничего не сообщает о содержимом почтового ящика.
• Результат «доставляемый» не означает согласия на связь по этому адресу.
• Запускайте новую проверку, когда для бизнес-решения нужен актуальный статус.

Очень большие списки: асинхронный вариант

Множественная проверка на панели и множественный эндпоинт API покрывают большинство списков. Отправлять весь файл как одну асинхронную массовую задачу имеет смысл, только когда список намного превышает эти лимиты.

• Загрузите файл .txt или .csv с одним адресом email на строку — на странице массовой проверки или через API.
• Проверка полного адреса принимает любые домены в одном файле; проверка аватара охватывает Gmail, Yandex и Mail.ru и принимает все три вперемешку в одном файле. Адреса вне этих трёх приводят к ошибке задачи на этапе подготовки файла — она не отправляется на проверку, и средства возвращаются полностью.
• При отправке баланс резервируется под допустимые строки, списание происходит только за адреса, по которым получен результат, а разница возвращается.
• Задача выполняется в фоне; скачайте файл с результатом после завершения. За неудавшуюся задачу сумма возвращается полностью.