新功能:按域名设置退订页和退订名单。了解工作方式 →

BillionSend

兼容 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>",
});

常见问题

了解更多

五分钟发出第一封邮件。