Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Quickstart

Konto anlegen, Domain verifizieren, API-Schlüssel erstellen und die erste E-Mail per curl oder Node.js-SDK senden, dann mit dem SES-Mailbox-Simulator testen.

1. Registrieren

Legen Sie auf billionsend.com ein Konto an. Dort finden Sie das Dashboard; die API liegt unter https://api.billionsend.com.

2. Domain verifizieren

Sie können nur von Domains senden, die Sie verifiziert haben.

  1. Öffnen Sie Domains und fügen Sie eine Domain hinzu, die Ihnen gehört, zum Beispiel acme.dev.
  2. Tragen Sie die angezeigten DNS-Einträge (DKIM und MAIL FROM) bei Ihrem DNS-Anbieter ein.
  3. Klicken Sie auf Domain verifizieren. Die Seite zeigt, welche Einträge noch fehlen.

Siehe Domains.

3. API-Schlüssel erstellen

Öffnen Sie API-Schlüssel und erstellen Sie einen. Der bs_-Schlüssel wird nur einmal angezeigt, kopieren Sie ihn also. Ein Schlüssel kann vollen Zugriff haben oder nur zum Senden dienen und lässt sich auf eine Domain beschränken.

4. E-Mail senden

Mit curl:

curl -X POST https://api.billionsend.com/emails \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <onboarding@acme.dev>",
    "to": ["success@simulator.amazonses.com"],
    "subject": "Hello from BillionSend",
    "html": "<strong>It works!</strong>"
  }'

Oder mit dem Node.js-SDK (npm install @billionsend/node):

import { BillionSend } from "@billionsend/node";

const bs = new BillionSend("bs_..."); // or new BillionSend() with BILLIONSEND_API_KEY set

const { data, error } = await bs.emails.send({
  from: "Acme <onboarding@acme.dev>",
  to: ["success@simulator.amazonses.com"],
  subject: "Hello from BillionSend",
  html: "<strong>It works!</strong>",
});

if (error) console.error(error.name, error.message);
else console.log("sent", data.id);

Beide geben { "id": "..." } zurück. Auf der Seite E-Mails sehen Sie, wie die E-Mail von queued zu delivered wechselt. Andere Sprachen: siehe SDKs.

Testen

  • success@simulator.amazonses.com simuliert eine Zustellung, ohne dass jemand eine E-Mail erhält. Mit einem Label bleiben die Adressen unterscheidbar: success+signup@simulator.amazonses.com.
  • E-Mails an den Simulator zählen trotzdem auf das Kontingent Ihres Tarifs.
  • bounce@, complaint@ und suppressionlist@ beim Simulator erzeugen echte Bounces und Beschwerden: Die Adresse landet auf Ihrer Sperrliste und das Event löst Ihre Webhooks aus, doch Simulator-Rückmeldungen zählen nie in Ihre Bounce- und Beschwerderaten. Nutzen Sie sie von Hand, nicht in automatisierten Tests. Jede Adresse funktioniert nur einmal, für eine frische Adresse ergänzen Sie ein Label: bounce+2@simulator.amazonses.com.
  • Adressen bei example.com oder unter .test und .invalid können keine E-Mails empfangen. Ein Versand an eine solche Adresse wird mit 422 abgelehnt (siehe API-Grundlagen).

Nächste Schritte

War diese Seite hilfreich?