---
title: 網域
description: 驗證寄件網域、新增 DNS 記錄，並設定追蹤、收信與預熱。
seo:
  title: 寄件網域設定
ai:
  exclude: true
---

每封 Email 都必須從團隊已驗證的網域寄出，其他任何 `from` 位址都會被拒絕，回傳 `422`。在控制台的**網域**新增並驗證網域，也可以透過 API 操作。

## 新增並驗證網域

```bash
curl -X POST https://api.billionsend.com/domains \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.example.com" }'
```

回應會列出要在你的 DNS 服務商新增的 DNS 記錄。寄件網域適合使用 `mail.example.com` 這類子網域。記錄生效後，在網域頁面按**驗證**，或呼叫 `POST /domains/{id}/verify`。

| 記錄 | 用途 |
| --- | --- |
| DKIM（兩筆 CNAME：`bs1._domainkey` 與 `bs2._domainkey`） | 為你的信件簽章，讓服務商知道這是你寄的。 |
| MAIL FROM（MX 與 TXT） | 在你自己的網域上設定退信位址，讓 SPF 能夠對齊。 |
| DMARC（TXT，建議設定） | 告訴服務商未通過檢查的信件該如何處理。它不會阻止寄送。 |

必須先通過 DKIM 與 MAIL FROM 驗證，才能寄信。在 Cloudflare 上，請讓這些記錄保持**僅限 DNS**（灰雲）。

網域頁面會顯示每筆記錄是已找到、遺漏還是不符，並即時對照公開 DNS 檢查。`GET /domains/{id}` 在 `records[]` 中回傳相同的內容。每筆記錄都有 `status`（`not_started`、`pending`、`verified` 或 `failed`）、表示公開 DNS 目前回應內容的 `live` 值，以及出問題時的簡短 `detail`。

### DKIM 金鑰會自動輪替

BillionSend 為每個網域建立一把 DKIM 金鑰，每 180 天更換一次，並在兩筆 CNAME 之間切換。你只需新增一次記錄，之後不必再動。可以在網域的**設定**分頁關閉自動輪替。

### 區域

`POST /domains` 可選擇帶入 `region`。一個網域只存在於一個區域。要搬移時，請刪除網域，再於另一個區域重新新增；它的 DNS 記錄會跟著改變。

### 方案限制

| | Free | Starter | Pro 與 Scale |
| --- | --- | --- | --- |
| 每個團隊的寄件網域數 | 3 | 10 | 無限制 |

超過限制後，`POST /domains` 會回應 `403 plan_limit_reached`。網域名稱已被其他團隊持有時，會回應 `409`。

## 新網域預熱

新註冊的網域在建立信譽期間，每日寄送量有上限。上限取決於註冊網域的年齡（`mail.example.com` 看的是 `example.com`），並依 UTC 日計算：

| 網域年齡 | 每日 Email 數 |
| --- | --- |
| 不到 1 天 | 100 |
| 1 天到不滿 7 天 | 300 |
| 7 天到不滿 30 天 | 2,000 |
| 30 天以上 | 只受你的方案限制 |

- 寄送表現良好、退信少且沒有投訴的網域，會更快升到下一個級距。
- 這個上限是疊加在你的方案之上，升級方案不會解除它。
- 你的新網域共用同一份每日額度：再新增一個新網域不會增加額度。
- 超過上限的信件不會遺失。它會顯示為**等待中**，並在隔天依先後順序寄出。如果已有大量信件在等待，寄送請求會回應 `429 daily_quota_exceeded`；請在 UTC 日換日後重試。

套用上限期間，網域頁面會顯示「預熱中：今日 N 封」。所有寄送保護機制請見[寄送限制](/docs/zh-hant/concepts/sending-limits)。

## 設定

網域通過驗證後，可使用以下設定：

- **開信與點擊追蹤。** 兩者預設都是關閉。在網域的**連結**分頁開啟，或對 `PATCH /domains/{id}` 使用 `open_tracking` 與 `click_tracking`。請見[追蹤](/docs/zh-hant/concepts/tracking)。
- **自有的追蹤與退訂子網域。** 讓追蹤連結與退訂連結從你自己的網域提供。需要付費方案。請見[追蹤](/docs/zh-hant/concepts/tracking)。
- **退訂頁面。** 收件者看到的頁面外觀：名稱、標誌、顏色與文字。在網域的**品牌**分頁設定，或對 `PATCH /domains/{id}` 使用 `unsubscribe_page`。請見[退訂](/docs/zh-hant/concepts/unsubscribes)。
- **強制 TLS。** 只寄送給支援 TLS 的伺服器。在**設定**分頁設定。
- **預設寄件人名稱、寄件人位址與 reply-to。** 在**設定**分頁設定。

## 收信

已驗證的網域也能[收信](/docs/zh-hant/receiving)。在網域頁面按**啟用收信**，或使用 `PATCH /domains/{id}` 開啟：

```json
{ "capabilities": { "receiving": "enabled" } }
```

- 只有已驗證的網域可以開啟收信。帶有 `"receiving": "enabled"` 的 `POST /domains` 會回應 `422`：請先新增網域、完成驗證，再開啟收信。
- 開啟後會新增兩筆 `Receiving` 記錄：指向 `mx1.billionsend-dns.com` 與 `mx2.billionsend-dns.com` 的 MX 記錄，優先順序都是 `10`。請兩筆都發布，這樣寄件方發現其中一台無法連線時，會改試另一台。它們不影響寄信。如果網域已經在其他地方收信，請把 MX 記錄放在 `inbound.example.com` 這類子網域上，因為編號較小的 MX 記錄會優先收走信件。
- 一個名稱只能在一個團隊收信。名稱已被其他團隊用來收信時，會回應 `409`。
- 預設只有你的[收件匣](/docs/zh-hant/inboxes)位址會收信。**全收（catch-all）** 會接受網域上的所有位址，需要付費方案，可在控制台設定，或對 `PATCH /domains/{id}` 使用 `receiving_catch_all`。

## 共用子網域

每個團隊還會在 BillionSend 的共用網域下取得一個子網域，團隊的共用[收件匣](/docs/zh-hant/inboxes)位址就建立在這裡。它會以 `shared: true` 出現在 `GET /domains` 的最後。它已經驗證完成且唯讀：`PATCH`、驗證與 `DELETE` 都會回應 `403 forbidden`，也不計入你的網域數量上限。它只能用你的收件匣自己的位址寄信。

## 刪除網域

`DELETE /domains/{id}`，或網域頁面的**刪除**，在兩種情況下會被拒絕並回應 `409`：

- 有[訂閱主題](/docs/zh-hant/concepts/topics)或[分群](/docs/zh-hant/concepts/segments)綁定到這個網域。請刪除它，或把它的 `domain_id` 設為 `null`。
- 有已排程或寄送中的[群發](/docs/zh-hant/concepts/broadcasts)使用這個網域。請取消它，或等它寄完。

刪除網域時，也會一併刪除它的收件匣。收件者對該網域的[退訂](/docs/zh-hant/concepts/unsubscribes)會保留，若你之後把同一個名稱加回來，退訂會再次生效。

## API 金鑰與網域

API 金鑰可以限制在單一網域。這樣的金鑰只能從該網域寄信，使用其他 `from` 會回應 `403 restricted_api_key`。它只能讀取該網域收到的信件，在 `/domains` 下只看得到、也只能更動該網域（其他網域會回應 `404`），它建立的金鑰也同樣限制在這個網域。Webhook、抑制清單、範本，以及其他屬於整個團隊的項目，都會回應 `403 restricted_api_key`；完整清單請見 [API 金鑰](/docs/zh-hant/api-keys)頁面。金鑰也可以限制在單一[收件匣](/docs/zh-hant/inboxes)。
