Test

Non testare mai con indirizzi inventati su domini reali: rimbalzano e danneggiano la reputazione del tuo mittente. SpacePost mette a disposizione caselle di test su test.spacepost.dev. Le email inviate a queste caselle non vengono consegnate da nessuna parte, ma l’intera pipeline di eventi viene eseguita, webhook inclusi.

Indirizzo	Simula	Eventi che vedrai
delivered@test.spacepost.dev	Consegna riuscita	email.sent, email.delivered
bounced@test.spacepost.dev	Rimbalzo definitivo (permanente)	email.sent, email.bounced
complained@test.spacepost.dev	Il destinatario segnala come spam	email.sent, email.delivered, email.complained
delayed@test.spacepost.dev	Problema temporaneo di consegna	email.sent, email.delivery_delayed
softbounced@test.spacepost.dev	Rimbalzo temporaneo (casella piena); il terzo entro 30 giorni sopprime l’indirizzo	email.sent, email.delivery_delayed

Etichette

Aggiungi +label per eseguire più scenari in parallelo e distinguerli: delivered+signup@test.spacepost.dev, bounced+case-17@test.spacepost.dev. L’etichetta viene ignorata quando si sceglie l’esito.

Attenzione

I rimbalzi definitivi e i reclami simulati si comportano come quelli reali: l’indirizzo viene aggiunto alla tua lista di soppressione e concorre alle soglie della pausa automatica. Dopo un test di rimbalzo, elimina le voci di test da Soppressioni nella dashboard o con DELETE /suppressions/{email}.

Il mittente di test

Prima di verificare un dominio puoi inviare da onboarding@test.spacepost.dev. È un mittente limitato:

• può inviare solo agli indirizzi email dei membri del tuo team e agli indirizzi @test.spacepost.dev;
• qualsiasi altro destinatario viene rifiutato con 403 validation_error;
• una volta verificato il tuo dominio, invia dal tuo indirizzo.

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>"
  }'

Testare il tuo gestore di webhook

1. Crea un webhook che punti a un tunnel verso la tua macchina (ad esempio https://abc123.ngrok.app/webhooks/spacepost), iscritto agli eventi che gestisci.
2. Invia a delivered@, bounced@, complained@ e delayed@.
3. Verifica che il tuo gestore controlli la firma e risponda con 2xx.

Gli invii di test contano sulla tua quota mensile come qualsiasi altra email.