SMTP 伺服器
在任何 SMTP 用戶端或框架的郵件元件中使用 BillionSend SMTP 伺服器(SMTP relay):主機、連接埠、TLS、限額、速率限制與所有回覆碼。
SMTP 伺服器(也稱 SMTP relay)接收來自任何 SMTP 用戶端或框架郵件元件的郵件,並比照 POST /emails 的方式傳送:寄件者檢查、抑制清單、方案限額與事件都與之相同。
連線
| 設定 | 值 |
|---|---|
| 主機 | smtp.billionsend.com |
| 連接埠,STARTTLS | 587 |
| 連接埠,隱式 TLS | 465 |
| 使用者名稱 | billionsend |
| 密碼 | 一把 API 金鑰(bs_...),例如 SMTP 頁面裡的 SMTP 憑證(見 API 金鑰) |
兩個連接埠都必須使用 TLS。僅限傳送的金鑰,或限定為單一網域或單一收件匣的金鑰,透過 SMTP 使用時同樣受這些限制。
curl --ssl-reqd smtp://smtp.billionsend.com:587 \
--user "billionsend:$BILLIONSEND_API_KEY" \
--mail-from hello@mail.example.com \
--mail-rcpt success@simulator.amazonses.com \
-T message.eml
SMTP 伺服器會檢查什麼
From地址必須屬於該金鑰所在團隊的已驗證網域。- 必須有非空的
Subject,以及 HTML 或純文字內文。 - 單封郵件最大 40 MiB,最多 50 位收件者。
- 附件規則與 API 相同:執行檔與偽裝的檔案類型會被拒絕。
- 郵件標頭遵循與
POST /emails相同的允許清單(X-*名稱、對話串、優先順序、List-Unsubscribe)。其他標頭一律由 BillionSend 自行寫入。 - 登入失敗三次就會中斷連線。一個工作階段最長 15 分鐘,同一個 IP 位址最多維持 10 個連線。
速率限制與重試
郵件與該金鑰的 API 請求共用同一個每分鐘限額。超出後,SMTP 伺服器會回覆 451 4.7.1,並附上需要等待的秒數。SMTP 用戶端會自動重試。
如果用戶端沒收到最後的 250,以同一個 Message-ID 重送了同一封郵件,拿到的是第一次的回應,不會再寄出第二封郵件。
錯誤
| 回覆 | 含義 |
|---|---|
530 / 535 |
缺少憑證或憑證錯誤 |
550 |
該金鑰不允許使用此寄件者,收件者無法收信,所有收件者都在抑制清單中,或團隊已被停權 |
552 |
郵件或附件太大 |
553 |
缺少主旨,或地址格式錯誤 |
554 |
郵件被拒絕,例如寄件網域未驗證,或標頭不被允許 |
451 |
暫時性錯誤:超出每分鐘限額(4.7.1,並附上需要等待的秒數),或傳送已暫停、等待傳送速率恢復。請重試。 |
452 |
收件者超過 50 位(其餘的請另寄一封),或某項額度已用完:每日積壓佇列已滿、當月用量已用完(週期更新後恢復)、新網域的預熱積壓佇列已滿,或收件匣的每日傳送上限已到 |