---
title: SMTP 服务
description: "在任意 SMTP 客户端或框架的邮件组件中使用 BillionSend SMTP 服务（SMTP 服务器 / SMTP 中继）：主机、端口、TLS、限额、速率限制和全部回复码。"
ai:
  exclude: true
---

SMTP 服务（也叫 SMTP 服务器、SMTP 中继）接收来自任意 SMTP 客户端或框架邮件组件的邮件，按 `POST /emails` 的方式发送：发件人检查、抑制列表、套餐限额和事件都与之相同。

## 连接

| 设置 | 值 |
| --- | --- |
| 主机 | `smtp.billionsend.com` |
| 端口，STARTTLS | `587` |
| 端口，隐式 TLS | `465` |
| 用户名 | `billionsend` |
| 密码 | 一个 [API 密钥](/docs/zh-hans/api-reference/basics)（`bs_...`），例如 **SMTP** 页面里的 SMTP 凭据（见 [API 密钥](/docs/zh-hans/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-hans/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 个（其余的请另发一封），或某项额度已用完：每日积压队列已满、当月用量已用完（周期续期后恢复）、新域名的预热积压队列已满，或收件箱的每日发送上限已到 |
