TypeScript · Express
通过 @messagebird/sdk 从 Express 5 POST 路由发送邮件。你需要一个 Bird API 密钥：在 Developers > API keys 中创建一个（发送第一封邮件有详细步骤），然后将其导出为 BIRD_API_KEY。
1. 安装
代码示例
npm init -y
npm install express @messagebird/sdk tsx2. 发送
创建 src/server.ts。Express 5 会将 async 处理函数中的 rejection 转发到错误中间件，因此不需要 try/catch 包装：
代码示例
import express from "express";
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const app = express();
app.post("/send", async (req, res) => {
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"
res.json({ id: msg.id, status: msg.status });
});
app.listen(3000);onboarding@messagebird.dev 是 Bird 的共享入门发件人，delivered@messagebird.dev 是始终可送达的沙盒收件人：无需域名验证。SDK 根据密钥的 bk_us1_ / bk_eu1_ 前缀推断区域（无需配置 base URL），并在每次调用时自动生成 Idempotency-Key，因此重试发送是安全的。
3. 试一试
启动服务器并向路由发送 POST 请求：
代码示例
npx tsx src/server.ts
curl -X POST http://localhost:3000/sendBird 以 202 接受邮件并异步投递；你的路由返回 em_ ID 和状态：
代码示例
{
"id": "em_01ky7ma8y2es1s2akzk53tmjn0",
"status": "accepted"
}后续步骤
- TypeScript 邮件 SDK：完整的邮件接口（send、get、list）及错误模型。
- 发送第一封邮件：创建 API 密钥及完整的沙盒地址列表。
- 发送域名：验证自有域名以用于生产环境发送。
- 邮件 API 参考：完整的请求和响应 schema。