SMTP 服务
在任意 SMTP 客户端或框架的邮件组件中使用 BillionSend SMTP 服务(SMTP 服务器 / SMTP 中继):主机、端口、TLS、限额、速率限制和全部回复码。
SMTP 服务(也叫 SMTP 服务器、SMTP 中继)接收来自任意 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 个(其余的请另发一封),或某项额度已用完:每日积压队列已满、当月用量已用完(周期续期后恢复)、新域名的预热积压队列已满,或收件箱的每日发送上限已到 |