TypeScript · Nuxt
使用 @messagebird/sdk 从 Nuxt 服务器路由（Nitro 事件处理程序）发送邮件。你需要一个 Bird API 密钥：在 Developers > API keys 中创建一个（发送第一封邮件提供了详细步骤），然后将其添加到 .env 中，设为 BIRD_API_KEY。
1. 安装
代码示例
npm create nuxt@latest my-app -- --packageManager npm --no-modules
cd my-app
npm install @messagebird/sdk2. 发送
创建 server/api/send.post.ts。server/ 下的所有内容仅在服务器端运行：
代码示例
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
export default defineEventHandler(async () => {
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 { id: msg.id, status: msg.status };
});onboarding@messagebird.dev 是 Bird 的共享入门发件人，delivered@messagebird.dev 是始终可送达的沙盒收件人，无需域名验证。SDK 会根据密钥的 bk_us1_ / bk_eu1_ 前缀推断区域（无需配置 base URL），并为每次调用自动生成一个 Idempotency-Key，因此重试发送是安全的。
3. 试一试
启动开发服务器并向该路由发送 POST 请求：
代码示例
npm run dev
curl -X POST http://localhost:3000/api/sendBird 以 202 接受邮件并异步投递；你的路由返回 em_ ID 和状态：
代码示例
{
"id": "em_01ky7ma8y2es1s2akzk53tmjn0",
"status": "accepted"
}后续步骤
- TypeScript 邮件 SDK：完整的邮件功能（send、get、list）及错误模型。
- 发送第一封邮件：创建 API 密钥及完整的沙盒地址列表。
- 发送域名：验证自有域名以用于生产环境发送。
- 邮件 API 参考：完整的请求和响应结构。