Tests

Ne testez jamais avec des adresses inventées sur de vrais domaines : elles rebondissent et nuisent à votre réputation d’expéditeur. SpacePost fournit des boîtes de test sur test.spacepost.dev. Les e-mails qui leur sont adressés ne sont distribués nulle part, mais toute la chaîne d’événements s’exécute, webhooks compris.

Adresse	Simule	Événements que vous verrez
delivered@test.spacepost.dev	Distribution réussie	email.sent, email.delivered
bounced@test.spacepost.dev	Rebond définitif (permanent)	email.sent, email.bounced
complained@test.spacepost.dev	Le destinataire signale l’e-mail comme spam	email.sent, email.delivered, email.complained
delayed@test.spacepost.dev	Problème de distribution temporaire	email.sent, email.delivery_delayed
softbounced@test.spacepost.dev	Rebond temporaire (boîte pleine) ; le troisième en 30 jours supprime l’adresse	email.sent, email.delivery_delayed

Étiquettes

Ajoutez +label pour exécuter plusieurs scénarios en parallèle et les distinguer : delivered+signup@test.spacepost.dev, bounced+case-17@test.spacepost.dev. L’étiquette est ignorée pour choisir le résultat.

Attention

Les rebonds définitifs et les plaintes simulés se comportent comme de vrais : l’adresse est ajoutée à votre liste de suppression et compte dans les seuils de mise en pause automatique. Après un test de rebond, supprimez les entrées de test depuis Suppressions dans le tableau de bord, ou avec DELETE /suppressions/{email}.

L’expéditeur de test

Avant de vérifier un domaine, vous pouvez envoyer depuis onboarding@test.spacepost.dev. Il est restreint :

• il ne peut envoyer qu’aux adresses e-mail des membres de votre équipe et aux adresses @test.spacepost.dev ;
• tout autre destinataire est rejeté avec 403 validation_error ;
• une fois votre domaine vérifié, envoyez depuis votre propre 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>"
  }'

Tester votre gestionnaire de webhook

1. Créez un webhook qui pointe vers un tunnel vers votre machine (par exemple https://abc123.ngrok.app/webhooks/spacepost), abonné aux événements que vous traitez.
2. Envoyez à delivered@, bounced@, complained@ et delayed@.
3. Vérifiez que votre gestionnaire vérifie la signature et répond 2xx.

Les envois de test comptent dans votre quota mensuel comme n’importe quel autre e-mail.