TypeScript · SvelteKit

Kirim email dari endpoint +server.ts SvelteKit dengan @messagebird/sdk. Anda memerlukan kunci API Bird: buat di Developers > API keys (Kirim email pertama Anda memandu prosesnya), lalu simpan di .env sebagai BIRD_API_KEY.

1. Instal

Contoh kode

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

2. Kirim

Buat src/routes/api/send/+server.ts. File +server.ts hanya berjalan di server, dan $env/static/private membaca BIRD_API_KEY dari .env tanpa pernah mengirimnya ke klien:

Contoh kode

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 adalah pengirim onboarding bersama milik Bird dan delivered@messagebird.dev adalah penerima sandbox yang selalu berhasil terkirim: tidak perlu verifikasi domain. SDK mendeteksi region dari prefiks bk_us1_ / bk_eu1_ pada kunci Anda (tidak perlu mengonfigurasi base URL) dan membuat Idempotency-Key otomatis per panggilan, sehingga pengiriman ulang aman.

3. Coba

Jalankan dev server dan POST ke endpoint:

Contoh kode

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

Bird menerima email dengan 202 dan mengirimnya secara asinkron; endpoint Anda mengembalikan ID em_ dan statusnya:

Contoh kode

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

Langkah selanjutnya

TypeScript email SDK: seluruh permukaan email (send, get, list) dan model kesalahan.
Kirim email pertama Anda: membuat kunci API dan daftar lengkap alamat sandbox.
Domain pengirim: verifikasi domain Anda sendiri untuk pengiriman produksi.
Referensi email API: skema request dan response lengkap.

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaGetting started with email Pahami konsepnyaShould I use a Bird SDK or call the API directly?Jelajahi kemampuannyaEmail Ikuti jalur pembelajaranBuild your first integration

Coba praktiknya dan dapatkan ringkasan implementasi