事务邮件,从已接受到已送达全程可追踪
用一次请求发送收据、密码重置和提醒。BillionSend 保存邮件、返回 id,并在后台发送,每次状态变化你都能实时看到。
事务邮件:能做什么
单封、批量和定时
可以发一封邮件,也可以一次请求发送最多 100 封的批量邮件,或用 scheduled_at 设置最长 30 天后发送。定时邮件在发出前可以改期或取消。
安全重试
加上 Idempotency-Key 请求头,想重试几次都行。相同的键和相同的内容只会返回最初的响应,不会多发一封。
附件、标签和请求头
每封邮件的附件总大小最多 10 MB。用标签给邮件分组,需要时还可以加自定义的 X- 请求头。
每封邮件都有状态
每封邮件会经历已定时、已发送、已送达、已延迟、已退信、已投诉、失败或已抑制,开启追踪后还有已打开和已点击。可以在「邮件」里查看,也可以通过 API 读取。
坏地址在发送前拦下
域名无法收信的地址,例如域名不存在、没有邮件服务器或属于一次性邮箱域名,会在发送时被拒绝,并返回明确的错误。
自动抑制
硬退信和投诉会进入抑制列表,之后的发送会跳过它们。如果所有收件人都被抑制,API 会如实告知,而不是假装已发出。
发送第一封邮件
使用官方的 Resend SDK,把 base URL 换成 BillionSend 的,并使用 bs_ 开头的 API 密钥。发件人地址必须属于你验证过的域名。
import { Resend } from "resend";const resend = new Resend("bs_...", { baseUrl: "https://api.billionsend.com" });const { data, error } = await resend.emails.send({ from: "Acme <hello@mail.example.com>", to: ["user@example.org"], subject: "Welcome", html: "<p>Thanks for signing up.</p>",});