---
title: 驗證
description: 每個位址都有免費的基本檢查，付費方案還能在寄信前對聯絡人做深度驗證。
seo:
  title: Email 驗證
ai:
  exclude: true
---

Email 驗證能讓信件避開會退信的位址，保護你的[送達率](/docs/zh-hant/concepts/deliverability-insights)。驗證分成兩個層級。

## 基本檢查（免費，所有方案）

每當 Email 被接受，以及每當建立或匯入聯絡人時，BillionSend 都會檢查收件者的網域。在以下情況，位址會被拒絕：

- 網域是保留名稱或文件範例名稱（`.test`、`.invalid`、`example.com` 等），或不是真實的頂級網域，
- 網域沒有郵件伺服器：網域不存在，或沒有發布 MX 記錄（或是 null MX），
- 網域屬於拋棄式 Email 服務。

被拒絕的寄送或聯絡人會回傳 `422 validation_error`，訊息類似 `x@example.com can never receive mail: …`。在批次匯入中，這些資料列會被略過。不會收取任何費用。要在不寄給任何人的情況下測試寄送，請使用 `success@simulator.amazonses.com`。

## 深度驗證（付費方案）

深度驗證會檢查每個信箱是否存在，過程中不會寄出任何信件給它。費用為**每 1,000 個位址 $0.40**，隨每月帳單結算（不需要預先儲值），Starter、Pro 與 Scale 都可使用。在 Free 上，驗證按鈕會停用，只套用基本檢查。

它只能用在你團隊中的聯絡人。如果你的團隊有免費的驗證額度，會在收費前先使用。

### 開始驗證

在控制台中，可以從以下位置開始：

- **聯絡人**：選取聯絡人，再按**驗證**。
- **分群**頁面：按**驗證**，檢查所有成員。
- **匯入對話框**：勾選**匯入後驗證**，檢查新增的聯絡人。
- **群發的「寄出前」面板**：它會顯示有多少收件者從未驗證過，並提供**立即驗證**。

開始之前，對話框會顯示將檢查多少個位址，以及費用。擁有者、管理員與行銷成員可以開始驗證。請見[團隊角色](/docs/zh-hant/team-roles)。

### 結果

每位聯絡人都會得到一個判定，顯示在**驗證**欄與聯絡人的頁面上：

| 判定 | 意義 |
| --- | --- |
| `valid` | 信箱存在。 |
| `invalid` | 信箱不存在。 |
| `risky` | 可能會退信。 |
| `catchall` | 網域接受所有位址，因此無法確認信箱是否存在。 |
| `role` | 共用位址，例如 `info@` 或 `support@`。 |
| `disposable` | 拋棄式信箱。 |
| `unknown` | 無法取得回應。 |

判定為 `invalid` 的位址會自動加入你的[抑制清單](/docs/zh-hant/concepts/suppressions)，因此不會有任何 Email 寄到它。其他判定只會替聯絡人加上標籤，聯絡人仍留在你的名單中，也仍會收到信。

### 如何計費

- 只有結果才需要付費：最後是 `unknown` 的位址不計費，失敗的執行也不計費。
- 已經有結果的聯絡人會被略過，正在另一次執行中驗證的聯絡人也會被略過。沒有位址會被重複計費。
- **設定 → 帳單與用量**會顯示本月已驗證的位址數與費用，以及你最近的執行。

### 限制

| | |
| --- | --- |
| 每次開始的聯絡人數 | 500,000。名單更大時，請依分群分批驗證。 |
| 每次執行的聯絡人數 | 50,000。更大的啟動會被拆成多次執行。 |
| 一次執行的時間 | 12 小時。到時還沒完成的執行會失敗。 |

### API

控制台能做的一切，API 也都做得到。目標的格式為 `{ "kind": "contacts", "contact_ids": [...] }`、`{ "kind": "segment", "segment_id": "..." }` 或 `{ "kind": "broadcast", "broadcast_id": "..." }`。

| 請求 | 作用 |
| --- | --- |
| `GET /verifications/availability` | 你的團隊能否開始深度驗證，以及每 1,000 個位址的價格。 |
| `POST /verifications/estimate` | 目標中有多少聯絡人從未驗證過，以及驗證它們的費用。不會變更任何內容。 |
| `POST /verifications` | 開始驗證目標。加上 `"recheck": true` 可以重新驗證曾經驗證過的聯絡人。 |
| `GET /verifications` | 你的執行記錄，最新的在前，附有狀態與結果。 |
| `GET /verifications/{id}` | 單次執行。 |

```bash
curl -X POST https://api.billionsend.com/verifications \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "target": { "kind": "segment", "segment_id": "seg_id" } }'
```

每位聯絡人的結果都在聯絡人身上：`GET /contacts/{id}` 與 `GET /contacts` 會回傳 `verification_status`（`valid`、`invalid`、`risky`、`catchall`、`role`、`disposable` 或 `unknown`）與 `verified_at`，聯絡人尚未驗證時兩者都是 `null`。`GET /usage` 會在 `verification` 下顯示本月已驗證的位址數與費用。開始執行需要具備完整權限的金鑰；在 Free 方案上會回應 `403 plan_limit_reached`。MCP 伺服器也有相同的五個動作（請見 [MCP](/docs/zh-hant/mcp)）。
