兼容 Resend 的 API:保留 SDK,只换 base URL
BillionSend 的 API 与 Resend 的路径、请求格式和错误格式相同。安装 Resend 官方的对应语言 SDK,指向 BillionSend,并使用 bs_ 开头的 API 密钥。你的代码不用动。
兼容 Resend 的 API:能做什么
Resend 的 SDK,或我们的 SDK
Resend 官方的 Node.js、Python、Go、Ruby、PHP、Rust、Java 和 .NET 包可以直接使用,你可以继续用现有的 SDK。BillionSend 也发布自己的 SDK,涵盖 Node.js、Python、Go、Ruby、PHP、Rust、Java、.NET 和 Elixir,覆盖所有端点,包括收件箱和收信。
同样的错误,同样的格式
错误以 statusCode、name 和 message 返回,与 Resend 一致,所以现有的错误处理照常工作。分页使用相同的 limit、after 和 before 游标。
用官方 SDK 测试
我们在契约测试里用官方的 resend SDK 调用我们的 API,会让 SDK 调用失效的改动,在发布前就会失败。
比 Resend 的 API 更多
在 Resend 的端点之外,还有收件箱和收到的邮件、联系人验证、邮件指标、退订记录、用量和送达率洞察。
差异写得清楚
BillionSend 有差异的地方,例如只支持内联 base64 附件,或退订限定在发信域名内,API 基础页都有列出。不支持的设置会返回 422,绝不会被悄悄忽略。
一条命令迁移账号
迁移工具会从 Resend 复制联系人、分群、订阅主题、模板、Webhook、域名和抑制记录。之后你的代码只需改两项设置。
把 SDK 指向 BillionSend
创建客户端时设置 base URL,或导出 RESEND_BASE_URL,并使用你的 bs_ 密钥。在 Node.js 中,base URL 末尾不带斜杠。其他语言各有设置方式,SDK 页面列出了每一种。
import { Resend } from "resend";const resend = new Resend("bs_...", { baseUrl: "https://api.billionsend.com" });await resend.emails.send({ from: "Acme <hello@mail.example.com>", to: "user@example.org", subject: "Hello", html: "<p>It works.</p>",});