TypeScript · Bun
通过 @messagebird/sdk 从 Bun.serve fetch 处理函数发送邮件。Bun 直接运行 TypeScript，无需构建步骤。你需要一个 Bird API 密钥：在 Developers > API keys 中创建（发送第一封邮件有完整步骤），然后将其作为 BIRD_API_KEY 放入 .env（Bun 会自动加载 .env）。
1. 安装
代码示例
bun init -y
bun add @messagebird/sdk2. 发送
创建 server.ts：
代码示例
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
Bun.serve({
port: 3000,
async fetch(req) {
if (req.method !== "POST") return new Response("Not found", { status: 404 });
const msg = await bird.email.send({
from: "onboarding@messagebird.dev",
to: ["delivered@messagebird.dev"],
subject: "Hello from Bird",
html: "<p>My first Bird email.</p>",
});
console.log(msg.id, msg.status); // "em_…", "accepted"
return Response.json({ id: msg.id, status: msg.status });
},
});onboarding@messagebird.dev 是 Bird 的共享入门发件人，delivered@messagebird.dev 是一个始终可送达的沙盒收件人，无需域名验证。SDK 根据密钥的 bk_us1_ / bk_eu1_ 前缀推断区域（无需配置 base URL），并为每次调用自动生成一个 Idempotency-Key，因此重试发送是安全的。
3. 试一试
启动服务器并向其发送 POST 请求：
代码示例
bun run server.ts
curl -X POST http://localhost:3000/Bird 以 202 接受邮件并异步投递；处理函数返回 em_ ID 和状态：
代码示例
{
"id": "em_01ky7ma8y2es1s2akzk53tmjn0",
"status": "accepted"
}后续步骤
- TypeScript 邮件 SDK：完整的邮件接口（send、get、list）及错误模型。
- 发送第一封邮件：创建 API 密钥以及完整的沙盒地址集。
- 发送域名：验证自有域名以用于生产环境发送。
- 邮件 API 参考：完整的请求和响应结构。