網域
驗證寄件網域、新增 DNS 記錄,並設定追蹤、收信與預熱。
每封 Email 都必須從團隊已驗證的網域寄出,其他任何 from 位址都會被拒絕,回傳 422。在控制台的網域新增並驗證網域,也可以透過 API 操作。
新增並驗證網域
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 封」。所有寄送保護機制請見寄送限制。
設定
網域通過驗證後,可使用以下設定:
- 開信與點擊追蹤。 兩者預設都是關閉。在網域的連結分頁開啟,或對
PATCH /domains/{id}使用open_tracking與click_tracking。請見追蹤。 - 自有的追蹤與退訂子網域。 讓追蹤連結與退訂連結從你自己的網域提供。需要付費方案。請見追蹤。
- 退訂頁面。 收件者看到的頁面外觀:名稱、標誌、顏色與文字。在網域的品牌分頁設定,或對
PATCH /domains/{id}使用unsubscribe_page。請見退訂。 - 強制 TLS。 只寄送給支援 TLS 的伺服器。在設定分頁設定。
- 預設寄件人名稱、寄件人位址與 reply-to。 在設定分頁設定。
收信
已驗證的網域也能收信。在網域頁面按啟用收信,或使用 PATCH /domains/{id} 開啟:
{ "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。 - 預設只有你的收件匣位址會收信。全收(catch-all) 會接受網域上的所有位址,需要付費方案,可在控制台設定,或對
PATCH /domains/{id}使用receiving_catch_all。
共用子網域
每個團隊還會在 BillionSend 的共用網域下取得一個子網域,團隊的共用收件匣位址就建立在這裡。它會以 shared: true 出現在 GET /domains 的最後。它已經驗證完成且唯讀:PATCH、驗證與 DELETE 都會回應 403 forbidden,也不計入你的網域數量上限。它只能用你的收件匣自己的位址寄信。
刪除網域
DELETE /domains/{id},或網域頁面的刪除,在兩種情況下會被拒絕並回應 409:
刪除網域時,也會一併刪除它的收件匣。收件者對該網域的退訂會保留,若你之後把同一個名稱加回來,退訂會再次生效。
API 金鑰與網域
API 金鑰可以限制在單一網域。這樣的金鑰只能從該網域寄信,使用其他 from 會回應 403 restricted_api_key。它只能讀取該網域收到的信件,在 /domains 下只看得到、也只能更動該網域(其他網域會回應 404),它建立的金鑰也同樣限制在這個網域。Webhook、抑制清單、範本,以及其他屬於整個團隊的項目,都會回應 403 restricted_api_key;完整清單請見 API 金鑰頁面。金鑰也可以限制在單一收件匣。