Глоссарий
Коды, описывающие нас, а не адрес
Некоторые коды объясняют, почему Emvero пропустил SMTP-пробу или не смог получить ее результат. Они описывают работу сервиса и не доказывают, что ящик недействителен.
Что описывают коды самого сервиса
В поле reason_codes могут быть сведения об адресе, ответе почтового сервера и работе Emvero. Коды на этой странице объясняют, почему проверка не получила нужных свидетельств о получателе. Здесь собраны несколько примеров ограничений сервиса; это не полный перечень связанных с ним причин.
Пропущенная проба и ограничения выполнения
SMTP_PROBE_NOT_REQUESTED означает, что запрос не предусматривал проверку ящика через SMTP. Так происходит при проверке домена. Этап пропущен намеренно, а сведения о домене и другие данные по-прежнему могут определить результат.
При SMTP_PACING_REFUSED Emvero не запустил попытку из-за собственного ограничения частоты проб. SMTP_EGRESS_UNAVAILABLE сообщает о недоступном ресурсе для исходящего соединения. SMTP_QUEUE_UNAVAILABLE и SMTP_SCHEDULER_UNAVAILABLE означают, что работу не удалось поставить в очередь или запланировать. Эти причины не являются отказом принимающего сервера.
Почему истечение срока не означает отсутствие соединения
SMTP_QUEUE_EXPIRED означает, что сервис не получил итоговый результат попытки за отведенное время. Срок мог истечь в очереди или уже после начала выполнения. По одному этому коду нельзя установить, подключался ли исполнитель к почтовому серверу.
У кода SMTP_GREYLISTED другой источник: он описывает временный отказ принимающего сервера. Отказ SMTP по политике также отражает решение другой стороны. Различие помогает понять, связано ли ограничение с работой Emvero или с ответом почтового сервера.
Когда ждать результат, а когда выбирать другой шаг
SMTP_QUEUED со статусом pending означает, что проверка продолжается. После интервала retry_after_ms запросите результат той же проверки. Если она завершилась с unknown, определенного ответа получить не удалось. Это завершенный результат, а не работа, которую нужно продолжать ждать. Для приложения задайте срок ожидания и правило на случай неопределенности, например обязательное подтверждение почты перед предоставлением доступа. Новая проверка позже может дать дополнительные свидетельства, но не гарантирует определенного исхода. Статус, действие и отдельные этапы разобраны в руководстве по чтению результата проверки.
Что возвращает сервис
Эти коды входят в словарь API и объясняют результат проверки. В пояснениях также указаны значения, которые текущие правила проверки или SMTP-проба не возвращают.
SMTP_PROBE_ NOT_ REQUESTED - SMTP-проба получателя не запрошена
SMTP_PACING_ REFUSED - Emvero отложил пробу из-за собственного ограничения частоты
SMTP_EGRESS_ UNAVAILABLE - Ресурс для исходящего соединения недоступен
SMTP_QUEUE_ UNAVAILABLE - Пробу не удалось поставить в очередь
SMTP_QUEUE_ EXPIRED - Результат SMTP-пробы не получен в срок; выполнение могло уже начаться
SMTP_SCHEDULER_ UNAVAILABLE - Пробу не удалось запланировать