跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

網域

驗證寄件網域、新增 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:

  • 有訂閱主題或分群綁定到這個網域。請刪除它,或把它的 domain_id 設為 null。
  • 有已排程或寄送中的群發使用這個網域。請取消它,或等它寄完。

刪除網域時,也會一併刪除它的收件匣。收件者對該網域的退訂會保留,若你之後把同一個名稱加回來,退訂會再次生效。

API 金鑰與網域

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

这个页面有帮助吗?