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.
- Öffnen Sie Domains und fügen Sie eine Domain hinzu, die Ihnen gehört, zum Beispiel
acme.dev. - Tragen Sie die angezeigten DNS-Einträge (DKIM und MAIL FROM) bei Ihrem DNS-Anbieter ein.
- 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.comsimuliert 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@undsuppressionlist@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.comoder unter.testund.invalidkönnen keine E-Mails empfangen. Ein Versand an eine solche Adresse wird mit422abgelehnt (siehe API-Grundlagen).
Nächste Schritte
- E-Mails, Kontakte und Newsletter-Versand.
- SDKs für Ihre Sprache.
- API-Referenz für jeden Endpunkt.