Коды причин верификации

Каждый результат верификации содержит поле reason, объясняющее, почему адрес электронной почты получил свой статус. Используйте этот справочник для построения точной логики фильтрации, диагностики неожиданных результатов и оптимизации стратегии рассылки.

Как работают причины

Поле reason присутствует во всех ответах верификации рядом с полем status:

{
  "email": "user@example.com",
  "status": "valid",
  "reason": "smtp_deliverable"
}

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

Valid (Действительный)

Письма со status: "valid" подтверждены как доставляемые.

Invalid (Недействительный)

Письма со status: "invalid" следует удалить из списка — доставка невозможна.

Unknown (Неизвестный)

Письма со status: "unknown" не удалось верифицировать окончательно. Некоторые носят временный характер (можно повторить попытку); другие представляют структурные ограничения.

Risky (Рискованный)

Письма со status: "risky" имеют умеренный риск доставляемости.

Catch-all (Ловит всё)

Письма со status: "catchall" принадлежат доменам, принимающим почту для всех адресов. Индивидуальную доставляемость подтвердить невозможно.

Role (Ролевой адрес)

Письма со status: "role" принадлежат общим почтовым ящикам (например, info@, support@, noreply@). Эти адреса обычно доставляемы, но имеют низкую вовлечённость.

Ролевые адреса наследуют reason от базовой проверки SMTP — для этого статуса нет специальных кодов причин. Например, ролевой адрес, прошедший SMTP, покажет reason: "smtp_deliverable".

Disposable (Одноразовый)

Письма со status: "disposable" принадлежат временным сервисам электронной почты. Принятие таких адресов обычно приводит к регистрациям низкого качества.

Использование причин при фильтрации

Вы можете комбинировать status и reason для точной сегментации списка. Например, чтобы сохранить письма unknown, которые являются неизвестными только из-за временных проблем:

function isRetryableUnknown(result) {
  const retryableReasons = new Set([
    'smtp_eof_blocked', 'smtp_timeout', 'smtp_rate_limited',
    'smtp_greylisted', 'mimecast_greylist', 'proofpoint_ad_lookup',
    'policy_temp_fail', 'google_rate_limit', 'm365_ip_rep_block',
    'dns_timeout', 'dns_lookup_error', 'yahoo_api_error',
    'yahoo_api_unavailable', 'yahoo_api_eof',
    'yahoo_api_unavailable_after_fallback', 'internal_verifier_error',
    'rate_limited', 'mx_only_verification_semaphore_timeout',
  ]);
  return result.status === 'unknown' && retryableReasons.has(result.reason);
}