Руководство по продукту
API проверки доставляемости email: обработка результатов «доставляемо» и «недоставляемо»
Узнайте, как интегрировать API проверки доставляемости email для обработки результатов «доставляемо», «недоставляемо» и неопределенных catch-all доменов.
Интегрируйте API проверки доставляемости email, чтобы различать доставляемые и недоставляемые адреса, а также неопределенные catch-all домены в синхронных и пакетных рабочих процессах.
EmailCheckPro предоставляет API проверки доставляемости email, который определяет, является ли адрес доставляемым (способным принимать почту) или недоставляемым на момент проверки. Вердикт «доставляемо» означает, что адрес может принимать сообщения в момент проверки, тогда как вердикт «недоставляемо» указывает на адрес, который не может принимать почту. Сервис оценивает адреса практически на любом домене, не отправляя сообщения получателям. Интегрируя рабочие процессы API в реальном времени и пакетную обработку, инженерные команды могут отделять активные адреса получателей от недоставляемых записей и неопределенных catch-all доменов, повышая качество передачи данных и поддерживая гигиену данных в системах сбора информации.
Основные вердикты доставляемости и операционная область
Оценка адресов получателей требует четкого разграничения между результатами «доставляемо», «недоставляемо» и «неопределенно».
Вердикт «доставляемо» подтверждает, что адрес получателя был доступен и готов к приему почты на момент проверки. И наоборот, результат «недоставляемо» указывает на то, что адрес не может принимать сообщения. Оба вердикта представляют собой завершенные результаты проверки.
Оценки доставляемости предоставляют сигналы о доступности на конкретный момент времени, а не постоянные гарантии. Команды разработчиков используют эти сигналы для удаления неактивных адресов из очередей рассылки, что помогает защитить производительность инфраструктуры, соблюдая при этом европейские принципы минимизации данных согласно GDPR Article 5 (Regulation (EU) 2016/679).
Синхронная интеграция для одиночных и пакетных проверок
Приложениям, собирающим контактные данные при регистрации или обновлении профиля, требуется быстрая синхронная оценка. EmailCheckPro предоставляет два специализированных эндпоинта реального времени для интерактивных рабочих процессов.
Для отправки отдельных запросов разработчики используют POST /api/v1/check с одним полным адресом.
При обработке небольших групп пользовательских данных POST /api/v1/batch-check обрабатывает от 1 до 100 адресов синхронно в рамках одного HTTP-запроса. Ответ с результатами множественной проверки сохраняет точную последовательность входного списка. Каждая запись включает свойство exists наряду с деталями проверки. В этой схеме exists=false означает, что сервис не сформировал завершенный результат для данной записи, а не вердикт «недоставляемо». Это различие позволяет системам сбора данных повторять попытки при временных сбоях, безопасно отфильтровывая подтвержденные недоставляемые записи.
Асинхронные пакетные задачи для обработки списков
Поддержка крупных баз данных требует архитектуры асинхронной обработки. При аудите хранилищ контактов системы отправляют задания на проверку через POST /api/v1/bulk-tasks.
Пакетные запросы принимают структурированные файлы TXT или CSV, содержащие по одному полному email-адресу на строку. Во время загрузки файла платформа автоматически удаляет дубликаты и некорректные записи, подготавливая чистую задачу. Применяются задокументированные ограничения на количество для каждого продукта; командам следует ознакомиться с официальной документацией для уточнения текущих лимитов задач.
Поскольку пакетные задания выполняются асинхронно, приложения отслеживают прогресс с помощью GET /api/v1/bulk-tasks/{id}. Клиентским рабочим процессам рекомендуется опрашивать этот эндпоинт не чаще одного раза в 30 секунд. После завершения обработки эндпоинт предоставляет result_url, ведущий к CSV-файлу, содержащему каждый идентификатор и его активированный результат. Сгенерированная ссылка для скачивания остается действительной в течение 12 часов и обновляется при каждом повторном запросе статуса задачи.
Обработка неопределенных catch-all доменов и ошибок форматирования
Надежные конвейеры качества данных должны различать явные сбои доставляемости и неоднозначные или некорректно сформированные входные данные.
Согласно RFC 5322: Internet Message Format, email-адрес состоит из локальной части и домена, соединенных символом @. Если входящая запись не имеет такой структуры, API обрабатывает полезную нагрузку как неверный формат. Неверный формат остается отличным от вердикта «недоставляемо», представляя собой структурную синтаксическую ошибку.
Почтовые серверы типа catch-all представляют собой еще одну операционную категорию. Эти домены принимают сообщения, адресованные любому произвольному локальному имени пользователя, что не позволяет механизму проверки окончательно изолировать валидные почтовые ящики. Вместо догадок EmailCheckPro помечает конфигурации catch-all как неопределенные. При проверке в реальном времени домены catch-all возвращают код состояния 42200 без завершенного результата. Неопределенные, неверные и неудачные проверки не тарифицируются, что позволяет командам направлять записи catch-all в отдельные очереди на рассмотрение.
Часто задаваемые вопросы
Что отличает вердикт «недоставляемо» от неопределенного результата?
Проверки в реальном времени для доменов catch-all возвращают код состояния 42200 без завершенного вердикта, оставляя такие адреса неоплаченными и доступными для отдельных политик рассмотрения.
Чем отличаются запросы API для множественной проверки от асинхронных пакетных задач?
Вызовы множественной проверки используют POST /api/v1/batch-check для синхронной валидации от 1 до 100 адресов, возвращая результаты непосредственно в ответе HTTP при сохранении порядка ввода. Асинхронные пакетные задачи используют POST /api/v1/bulk-tasks для обработки больших списков TXT или CSV. Пакетные задачи выполняются в фоновом режиме, требуют опроса GET /api/v1/bulk-tasks/{id} с интервалом в 30 секунд и выводят CSV-файл для скачивания через result_url, действительный в течение 12 часов.
Узнайте больше
Выберите информацию о продукте, которая соответствует следующему шагу в вашем рабочем процессе.