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

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 个(其余的请另发一封),或某项额度已用完:每日积压队列已满、当月用量已用完(周期续期后恢复)、新域名的预热积压队列已满,或收件箱的每日发送上限已到

这个页面有帮助吗?