Sign inGet Started
Jetzt starten
Anleitungen
API-Referenz
SDKs
CLI
Wissensdatenbank
Changelog

TypeScript · SvelteKit

Senden Sie eine E-Mail von einem SvelteKit-+server.ts-Endpoint mit @messagebird/sdk. Sie benötigen einen Bird-API-Schlüssel: Erstellen Sie einen unter Developers > API keys (Ihre erste E-Mail senden führt Sie durch den Vorgang) und hinterlegen Sie ihn in .env als BIRD_API_KEY.

1. Installieren

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

2. Senden

Erstellen Sie src/routes/api/send/+server.ts. +server.ts-Dateien laufen nur auf dem Server, und $env/static/private liest BIRD_API_KEY aus .env, ohne es jemals an den Client auszuliefern:
Codebeispiel
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 ist der gemeinsame Onboarding-Absender von Bird und delivered@messagebird.dev ist ein Sandbox-Empfänger, der immer zugestellt wird: keine Domain-Verifizierung nötig. Das SDK leitet die Region aus dem bk_us1_-/bk_eu1_-Präfix Ihres Schlüssels ab (keine Base-URL zu konfigurieren) und erzeugt automatisch einen Idempotency-Key pro Aufruf, sodass wiederholte Sendungen sicher sind.

3. Ausprobieren

Starten Sie den Dev-Server und senden Sie einen POST an den Endpoint:
Codebeispiel
npm run dev
curl -X POST http://localhost:5173/api/send
Bird nimmt die E-Mail mit einem 202 an und stellt sie asynchron zu; Ihr Endpoint gibt die em_-ID und den Status zurück:
Codebeispiel
{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}

Nächste Schritte

Verwandte Ressourcen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.

Anleitung ansehenGetting started with emailDas Konzept verstehenShould I use a Bird SDK or call the API directly?Die Funktion erkundenEmailDem Lernpfad folgenBuild your first integration
Übung ausprobieren und ein Implementierungs-Briefing erhalten