BillionVerify LogoBillionVerify

驗證原因碼

BillionVerify API 回傳的所有驗證原因碼參考手冊——每個原因碼的含義及處理建議。

看看它是怎麼用的

信箱驗證是如何運作的?一層一層講清楚

信箱驗證如何運作,從語法檢查到 SMTP:跟著一個地址走過決定其結果的九個層級。瞭解地址會在哪裡提前停下、郵件伺服器的回覆如何解讀、Catch-all 如何偵測,以及每種結果的費用。

每筆驗證結果都包含一個 reason 欄位,用於說明該信箱為何得到目前的狀態。參考本文件可建立精準的篩選規則、診斷異常結果,並調整寄送策略。

原因碼的運作方式

reason 欄位會與 status 欄位一同出現在所有驗證回應中:

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

原因碼是穩定的字串識別碼,可直接用於篩選規則或下游的條件邏輯。

各類信箱的驗證方式

會得到哪個原因碼,取決於收件方服務商允許以何種方式檢查:

  • 企業網域(Google Workspace、Microsoft 365、自建郵件伺服器)會針對具體信箱進行即時 SMTP RCPT 檢查。檢查時會先探測同一網域下的一個隨機地址,因此 catch-all(全收)網域、Microsoft 365 內部中繼,以及處於全收模式的安全閘道,都會被回報為 catchall,而不是 valid。
  • Gmail 會進行即時 SMTP RCPT 檢查。
  • Yahoo、AOL、Outlook.com、Hotmail、Live 和 MSN 會封鎖 SMTP 驗證,因此透過各服務商專屬的帳號查詢來檢查。這類結果會回傳 yahoo_api_* 或 microsoft_api_* 原因碼,用於確認帳號是否存在。
  • GMX、web.de、Mail.ru、Yandex 及其他區域性服務商依各服務商專屬的節奏進行驗證。速率限制、灰名單和拒絕檢查會帶來更多 unknown 結果。
  • Apple iCloud、Proton 和 Tuta 不允許任何可靠的檢查,其地址一律回傳 unknown,原因碼為 smtp_unverifiable。

無論原因碼為何,unknown 結果都不計費。

valid(有效)

status: "valid" 的信箱經確認可投遞。

原因碼說明
smtp_deliverableSMTP RCPT 回傳 250 OK——信箱確認可投遞。Microsoft 365 DBEB 模式確認投遞時也會回傳此原因碼。
yahoo_api_verifiedYahoo 或 AOL 帳號查詢確認該帳號存在。
microsoft_api_verifiedMicrosoft 個人帳號查詢(Outlook.com、Hotmail、Live、MSN)確認該帳號存在。
unitedinternet_api_verifiedGMX.com / mail.com 帳號查詢確認該帳號存在。

invalid(無效)

status: "invalid" 的信箱應從名單中移除——無法投遞。

原因碼說明
invalid_syntax電子郵件地址語法解析失敗——本地部分或網域格式有誤,或缺少 @。不計費。
no_mx_records網域沒有 MX 記錄(NXDOMAIN 或 MX 查詢結果為空)。
null_mx網域發布了 null MX 記錄(RFC 7505)——明確表示不接收任何郵件。
spf_reject_all網域沒有 MX 記錄,且 SPF 記錄包含 -all——網域明確拒絕所有入站郵件。
mailbox_not_foundSMTP 550/5xx 確認遠端伺服器上不存在該信箱。
mailbox_disabled信箱存在,但已被停用或停權。
host_not_foundMX 主機名稱無回應——主機無法連線或不存在。
yahoo_api_not_deliverableYahoo 或 AOL 帳號查詢確認該帳號不存在。
microsoft_api_not_deliverableMicrosoft 個人帳號查詢確認該帳號不存在。
unitedinternet_api_not_deliverableGMX.com / mail.com 帳號查詢確認該帳號不存在。

unknown(未知)

status: "unknown" 的信箱無法得出確定的結論。unknown 結果一律不計費。部分原因是暫時性的(可重試),其餘則屬於結構性限制。

原因碼可重試說明
smtp_unverifiable否該服務商不允許任何可靠的 SMTP 驗證(Apple iCloud、Proton、Tuta)。
smtp_blocked否遠端 SMTP 伺服器明確封鎖或禁止了連線。
smtp_eof_blocked是MX 伺服器在發送 banner 之前就關閉了連線——通常是依 IP 的速率限制器或 fail2ban 規則所致。
smtp_timeout是SMTP 操作逾時(context 到期或被取消)。
smtp_connection_failed是一般性的 SMTP 連線失敗——沒有更具體的分類符合。
smtp_rate_limited是遠端 SMTP 伺服器回傳了速率限制回應(421、450、451 或超出郵件數量上限)。
smtp_greylisted是偵測到一般性的灰名單回應——延遲後可重試。
smtp_550_unclassified是伺服器回傳的 550 並未明確表示「使用者不存在」,因此不判定為 invalid。
smtp_egress_unavailable是檢查時沒有可用於該服務商的驗證出口。
smtp_egress_unselectable否沒有任何驗證出口被允許存取該服務商。
mimecast_greylist是Mimecast 專屬的灰名單 / 451 暫時性失敗。
proofpoint_ad_lookup是Proofpoint AD 非同步查詢進行中(收件者驗證時回傳 421 4.1.1 暫時性失敗)。
proofpoint_egress_listed否受 Proofpoint 保護的網域,目前不回應我們的檢查。
policy_temp_fail是遠端政策強制執行導致的一般性 4xx 暫時性失敗。
google_rate_limit是Google MX 回傳了速率限制或暫時性拒絕回應。
google_dmarc_misalignment否網域 DMARC 設定未對齊——Google 依 DMARC 政策拒絕。
m365_ip_rep_block是Microsoft 365 因 IP 信譽問題拒絕連線(4.7.650 / 4.7.651 代碼)。
tonline_egress_not_whitelisted否T-Online 只接受來自白名單寄件方的檢查,因此無法驗證該信箱。
mailbox_full否信箱存在,但已超出配額(SMTP 452 或信箱已滿的回應)。
dns_timeout是DNS 或 MX 查詢逾時——解析器的暫時性問題。
dns_lookup_error是DNS 查詢失敗,且不是 NXDOMAIN 錯誤(SERVFAIL、UDP 逾時或解析器錯誤)。
dns_resolution_failed是因暫時性原因導致 DNS 解析失敗。
yahoo_api_error是Yahoo / AOL 帳號查詢失敗——一般性錯誤。
yahoo_api_unavailable是Yahoo / AOL 帳號查詢無法使用(批次層級的健康檢查失敗)。
yahoo_api_eof是Yahoo / AOL 帳號查詢回傳提前 EOF——TCP/TLS 連線暫時中斷。
yahoo_api_rate_limited是Yahoo / AOL 帳號查詢被限速。
microsoft_api_error是Microsoft 個人帳號查詢失敗或被限流。
microsoft_api_unavailable是Microsoft 個人帳號查詢無法使用。
unitedinternet_api_error是GMX.com / mail.com 帳號查詢失敗。
unitedinternet_api_unavailable否GMX.com / mail.com 帳號查詢在本次執行中無法使用。
capacity_deferred是該服務商的驗證容量已滿,本次檢查被延後。
provider_capacity_exhausted否該服務商的容量在整個重試時間窗(約兩小時)內一直處於已滿狀態,因此任務結束時這些地址仍沒有結論。
carrier_blocked否日本電信業者網域(docomo.ne.jp、au.com 等)——業者政策封鎖 SMTP。
internal_verifier_error是未分類的內部驗證器錯誤——暫時性故障。
rate_limited是信箱在批次處理期間被限速(檔案任務中 smtp_rate_limited 的別名)。
bucket_default_skip_smtp_unknown否帳戶層級的驗證模式設定為略過 SMTP——結果僅依據網域檢查。
mx_only_verification_semaphore_timeout是SMTP 並行號誌逾時——僅 MX 的備援驗證確認 MX 記錄有效,但無法單獨驗證該信箱。

catch-all(全收網域)

status: "catchall" 的信箱屬於接受所有地址郵件的網域,無法確認單一地址是否可投遞。

原因碼說明
catch_all_domain網域確認為 catch-all——隨機 RCPT 探測被郵件伺服器接受。
catch_all_deliverableCatch-all 網域,且該具體地址的 RCPT 也回傳了 250 OK。
catch_all_inferred根據快取證據推斷出 catch-all 狀態(間接推斷,並非即時探測)。
m365_internal_relayMicrosoft 365 網域設定為內部中繼——所有 RCPT 均被接受,但未逐一驗證。
gateway_accept_all安全閘道(Mimecast、Proofpoint 等)處於全收模式。
forwarding_alias郵件轉寄別名服務(SimpleLogin、Firefox Relay、Duck.com)。
yahoo_isp_accept_all託管在 Yahoo 郵件基礎設施上的 ISP 網域(例如 att.net、sbcglobal.net、verizon.net)——服務商接受所有收件者,因此無法進行信箱層級的檢查。
region_consumer_accept_all已知接受所有入站郵件的區域性個人信箱網域(較早的結果)。
bucket_default_skip_smtp_catchall帳戶層級的驗證模式設定為略過 SMTP catch-all 檢查。

role(角色信箱)

status: "role" 的信箱屬於共用收件匣(例如 info@、support@、noreply@)。這類地址通常可投遞,但互動率較低。

角色信箱會繼承其底層 SMTP 檢查的 reason——該狀態沒有專屬原因碼。例如,通過 SMTP 檢查的角色信箱會顯示 reason: "smtp_deliverable"。

disposable(一次性信箱)

status: "disposable" 的信箱屬於臨時信箱服務。接受這類信箱通常會帶來低品質的註冊。

原因碼說明
disposable_domain網域被列為已知的一次性 / 臨時信箱服務商。

risky(高風險,僅舊結果)

新的驗證不再回傳 status: "risky"。它唯一的來源——Spamhaus 網域黑名單檢查——已於 2026-09-11 移除。在該日期之前產生的結果中,你仍可能看到 risky。

在這些舊結果中,risky 表示該地址多半可投遞,但收件網域被 Spamhaus 收錄為垃圾郵件、網路釣魚、惡意軟體或殭屍網路 C&C 活動的來源。risk_reasons 陣列會說明具體原因:

risk_reasons 取值說明
spamhaus_dbl_spam該網域被收錄為垃圾郵件來源。
spamhaus_dbl_phish該網域被收錄為網路釣魚網域。
spamhaus_dbl_malware該網域被收錄為惡意軟體散布網域。
spamhaus_dbl_botnet_cc該網域被收錄為殭屍網路的命令與控制基礎設施。

依原因碼篩選

結合 status 和 reason 可實現精準的名單分類。例如,僅保留因暫時性問題而處於 unknown 的信箱:

function isRetryableUnknown(result) {
  const retryableReasons = new Set([
    'capacity_deferred', 'context_cancelled', 'dns_lookup_error',
    'dns_resolution_failed', 'dns_timeout', 'google_rate_limit',
    'internal_verifier_error', 'm365_ip_rep_block', 'microsoft_api_error',
    'microsoft_api_unavailable', 'mimecast_greylist',
    'mx_only_verification_semaphore_timeout', 'policy_temp_fail',
    'proofpoint_ad_lookup', 'rate_limited', 'smtp_550_unclassified',
    'smtp_connection_failed', 'smtp_egress_unavailable', 'smtp_eof_blocked',
    'smtp_greylisted', 'smtp_rate_check_failed', 'smtp_rate_limited',
    'smtp_rate_wait_failed', 'smtp_timeout', 'unitedinternet_api_error',
    'yahoo_api_eof', 'yahoo_api_error', 'yahoo_api_rate_limited',
    'yahoo_api_unavailable',
  ]);
  return result.status === 'unknown' && retryableReasons.has(result.reason);
}

On this page