Testes

Nunca teste com endereços inventados em domínios reais: eles rejeitam a mensagem e prejudicam a reputação do seu remetente. O SpacePost oferece caixas de teste em test.spacepost.dev. Os e-mails enviados a elas nunca são entregues a lugar nenhum, mas todo o pipeline de eventos é executado, inclusive os webhooks.

Endereço	Simula	Eventos que você verá
delivered@test.spacepost.dev	Entrega bem-sucedida	email.sent, email.delivered
bounced@test.spacepost.dev	Rejeição permanente (hard bounce)	email.sent, email.bounced
complained@test.spacepost.dev	O destinatário marca como spam	email.sent, email.delivered, email.complained
delayed@test.spacepost.dev	Problema temporário de entrega	email.sent, email.delivery_delayed
softbounced@test.spacepost.dev	Rejeição temporária (soft bounce, caixa cheia); a terceira em 30 dias suprime o endereço	email.sent, email.delivery_delayed

Rótulos

Adicione +rótulo para executar vários cenários em paralelo e distingui-los: delivered+signup@test.spacepost.dev, bounced+case-17@test.spacepost.dev. O rótulo é ignorado na escolha do resultado.

Cuidado

Rejeições permanentes e reclamações simuladas se comportam como as reais: o endereço é adicionado à sua lista de supressão e conta para os limites da pausa automática. Depois de executar um teste de rejeição, exclua as entradas de teste em Supressões no painel ou com DELETE /suppressions/{email}.

O remetente de teste

Antes de verificar um domínio, você pode enviar de onboarding@test.spacepost.dev. Ele tem restrições:

• só envia para os endereços de e-mail dos membros da sua equipe e para endereços @test.spacepost.dev;
• qualquer outro destinatário é rejeitado com 403 validation_error;
• depois que seu domínio estiver verificado, envie do seu próprio endereço.

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

Testando seu handler de webhook

1. Crie um webhook que aponte para um túnel até a sua máquina (por exemplo, https://abc123.ngrok.app/webhooks/spacepost), assinando os eventos que você trata.
2. Envie para delivered@, bounced@, complained@ e delayed@.
3. Confira se o seu handler verifica a assinatura e responde 2xx.

Os envios de teste contam para a sua cota mensal como qualquer outro e-mail.