---
title: SMTP 伺服器
description: "在任何 SMTP 用戶端或框架的郵件元件中使用 BillionSend SMTP 伺服器（SMTP relay）：主機、連接埠、TLS、限額、速率限制與所有回覆碼。"
ai:
  exclude: true
---

SMTP 伺服器（也稱 SMTP relay）接收來自任何 SMTP 用戶端或框架郵件元件的郵件，並比照 `POST /emails` 的方式傳送：寄件者檢查、抑制清單、方案限額與事件都與之相同。

## 連線

| 設定 | 值 |
| --- | --- |
| 主機 | `smtp.billionsend.com` |
| 連接埠，STARTTLS | `587` |
| 連接埠，隱式 TLS | `465` |
| 使用者名稱 | `billionsend` |
| 密碼 | 一把 [API 金鑰](/docs/zh-hant/api-reference/basics)（`bs_...`），例如 **SMTP** 頁面裡的 SMTP 憑證（見 [API 金鑰](/docs/zh-hant/api-keys)） |

兩個連接埠都必須使用 TLS。僅限傳送的金鑰，或限定為單一網域或單一收件匣的金鑰，透過 SMTP 使用時同樣受這些限制。

```bash
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` 地址必須屬於該金鑰所在團隊的[已驗證網域](/docs/zh-hant/concepts/domains)。
- 必須有非空的 `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 位（其餘的請另寄一封），或某項額度已用完：每日積壓佇列已滿、當月用量已用完（週期更新後恢復）、新網域的預熱積壓佇列已滿，或收件匣的每日傳送上限已到 |
