TypeScript · SvelteKit

使用 @messagebird/sdk 从 SvelteKit +server.ts 端点发送邮件。你需要一个 Bird API 密钥：在 Developers > API keys 中创建一个（发送第一封邮件有详细说明），然后将它放入 .env，设为 BIRD_API_KEY。

1. 安装

代码示例

npx sv create my-app --template minimal --types ts --no-add-ons --install npm
cd my-app
npm install @messagebird/sdk

2. 发送

创建 src/routes/api/send/+server.ts。+server.ts 文件仅在服务端运行，$env/static/private 从 .env 读取 BIRD_API_KEY，不会将其发送到客户端：

代码示例

import { json } from "@sveltejs/kit";
import { BIRD_API_KEY } from "$env/static/private";
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: BIRD_API_KEY });

export async function POST() {
  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 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 请求：

代码示例

npm run dev
curl -X POST http://localhost:5173/api/send

Bird 以 202 接受邮件并异步投递；你的端点返回 em_ ID 和状态：

代码示例

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}

后续步骤

TypeScript 邮件 SDK：完整的邮件功能（send、get、list）和错误模型。
发送第一封邮件：创建 API 密钥以及完整的沙盒地址列表。
发送域名：验证你自己的域名以用于生产环境发送。
邮件 API 参考：完整的请求和响应结构。

TypeScript · SvelteKit

1. 安装

2. 发送

3. 试用

后续步骤

相关资源