Глоссарий
Троттлинг и лимиты
SMTP-троттлинг ограничивает частоту обращений к почтовому серверу. Из-за лимита проверка может не получить ответ о ящике; тайм-аут или отказ в соединении сами по себе не подтверждают такой лимит.
SMTP-троттлинг — ограничение частоты соединений или команд, которые один источник может отправлять почтовому серверу. Код SMTP_PROVIDER_THROTTLED означает, что Emvero распознал такое ограничение со стороны принимающего сервера. Оно мешает получить ответ о ящике, но не устанавливает, существует ли ящик.
Как отличить лимит от ошибки соединения
SMTP_CONNECT_REFUSED означает отказ в установлении соединения, а SMTP_CONNECT_TIMEOUT — истечение времени ожидания подключения. Оба случая возможны без ограничения частоты запросов: например, при проблеме сети или недоступности сервера. Сохраняйте точный код причины, чтобы не смешивать разные исходы.
Временный SMTP-ответ также не всегда связан с лимитом. Код 421 означает, что сервис недоступен и соединение закрывается; его значение определено в RFC 5321. По одному номеру нельзя установить ограничение частоты. Грейлистинг — еще одна возможная причина отсрочки, которую нужно рассматривать отдельно.
Когда пробу откладывает сам Emvero
PROVIDER_CIRCUIT_OPEN описывает работу защитного механизма Emvero. После неудачных попыток сервис может приостановить новые пробы для определенной группы принимающих серверов. Этот код сообщает о решении не запускать пробу; нового ответа о получателе в такой попытке нет. Другие случаи разобраны в статье об ограничениях самого сервиса проверки.
Код SMTP_QUEUED означает, что SMTP-проба ожидает выполнения или уже выполняется. При статусе pending запросите результат той же проверки после интервала retry_after_ms. Если работа завершена, но определенного ответа нет, Emvero возвращает unknown и allow_with_email_confirmation, когда другие свидетельства не определяют иной результат. Поля объясняются в статье о чтении результата проверки.
После временного ограничения новая проверка позже может дать дополнительные сведения. Однако новый запрос не гарантирует свежих данных или принятия получателя. При регистрации ваше приложение может отправить письмо с подтверждением; SMTP-проба Emvero письма не отправляет. При работе со списком сохраните причину и решите, когда вернуться к адресу. Сравнение unknown и undeliverable объясняет, почему неполной проверки недостаточно для вывода, что ящик не работает.
Что возвращает сервис
Эти коды входят в словарь API и объясняют результат проверки. В пояснениях также указаны значения, которые текущие правила проверки или SMTP-проба не возвращают.
SMTP_PROVIDER_ THROTTLED - Провайдер ограничил проверку
PROVIDER_CIRCUIT_ OPEN - Emvero временно приостановил новые пробы для группы серверов; нового ответа о получателе нет
SMTP_CONNECT_ REFUSED - Почтовый сервер отклонил соединение
SMTP_CONNECT_ TIMEOUT - SMTP-соединение не установлено до истечения срока ожидания
SMTP_QUEUED - SMTP-проба ожидает выполнения или уже выполняется