Testen

Teste nie mit ausgedachten Adressen bei echten Domains: Sie verursachen Bounces und schaden deiner Absender-Reputation. SpacePost stellt Test-Postfächer unter test.spacepost.dev bereit. E-Mails an diese Adressen werden nirgendwohin zugestellt, aber die gesamte Event-Pipeline läuft, einschließlich Webhooks.

Adresse	Simuliert	Events, die du siehst
delivered@test.spacepost.dev	Erfolgreiche Zustellung	email.sent, email.delivered
bounced@test.spacepost.dev	Hard Bounce (dauerhaft)	email.sent, email.bounced
complained@test.spacepost.dev	Empfänger markiert als Spam	email.sent, email.delivered, email.complained
delayed@test.spacepost.dev	Vorübergehendes Zustellproblem	email.sent, email.delivery_delayed
softbounced@test.spacepost.dev	Soft Bounce (Postfach voll); beim dritten innerhalb von 30 Tagen wird die Adresse gesperrt	email.sent, email.delivery_delayed

Labels

Hänge +label an, um mehrere Szenarien parallel auszuführen und voneinander zu unterscheiden: delivered+signup@test.spacepost.dev, bounced+case-17@test.spacepost.dev. Das Label wird bei der Wahl des Ergebnisses ignoriert.

Achtung

Simulierte Hard Bounces und Beschwerden verhalten sich wie echte: Die Adresse wird deiner Sperrliste hinzugefügt und zählt für die Schwellenwerte des automatischen Pausierens. Lösche Testeinträge nach einem Bounce-Test unter Sperrliste im Dashboard oder mit DELETE /suppressions/{email}.

Der Test-Absender

Bevor du eine Domain verifizierst, kannst du von onboarding@test.spacepost.dev senden. Er ist eingeschränkt:

• Er kann nur an die E-Mail-Adressen deiner eigenen Teammitglieder und an @test.spacepost.dev-Adressen senden;
• jeder andere Empfänger wird mit 403 validation_error abgelehnt;
• sobald deine Domain verifiziert ist, sendest du von deiner eigenen Adresse.

Node.js

test.ts

import { SpacePost } from "@spacepost/node";

const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);

await spacepost.emails.send({
  from: "Acme <onboarding@test.spacepost.dev>",
  to: ["delivered@test.spacepost.dev", "bounced+case-1@test.spacepost.dev"],
  subject: "Test",
  html: "<p>Test</p>",
});

cURL

curl -X POST https://api.spacepost.dev/emails \
  -H "Authorization: Bearer $SPACEPOST_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <onboarding@test.spacepost.dev>",
    "to": ["delivered@test.spacepost.dev"],
    "subject": "Test",
    "html": "<p>Test</p>"
  }'

Deinen Webhook-Handler testen

1. Erstelle einen Webhook, der auf einen Tunnel zu deinem Rechner zeigt (zum Beispiel https://abc123.ngrok.app/webhooks/spacepost) und die Events abonniert, die du verarbeitest.
2. Sende an delivered@, bounced@, complained@ und delayed@.
3. Prüfe, dass dein Handler die Signatur verifiziert und mit 2xx antwortet.

Testsendungen zählen wie jede andere E-Mail auf dein monatliches Kontingent.