驗證原因碼
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_deliverable | SMTP RCPT 回傳 250 OK——信箱確認可投遞。Microsoft 365 DBEB 模式確認投遞時也會回傳此原因碼。 |
yahoo_api_verified | Yahoo 或 AOL 帳號查詢確認該帳號存在。 |
microsoft_api_verified | Microsoft 個人帳號查詢(Outlook.com、Hotmail、Live、MSN)確認該帳號存在。 |
unitedinternet_api_verified | GMX.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_found | SMTP 550/5xx 確認遠端伺服器上不存在該信箱。 |
mailbox_disabled | 信箱存在,但已被停用或停權。 |
host_not_found | MX 主機名稱無回應——主機無法連線或不存在。 |
yahoo_api_not_deliverable | Yahoo 或 AOL 帳號查詢確認該帳號不存在。 |
microsoft_api_not_deliverable | Microsoft 個人帳號查詢確認該帳號不存在。 |
unitedinternet_api_not_deliverable | GMX.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_deliverable | Catch-all 網域,且該具體地址的 RCPT 也回傳了 250 OK。 |
catch_all_inferred | 根據快取證據推斷出 catch-all 狀態(間接推斷,並非即時探測)。 |
m365_internal_relay | Microsoft 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);
}