Pruebas

Nunca pruebes con direcciones inventadas en dominios reales: rebotan y dañan la reputación de tu remitente. SpacePost ofrece buzones de prueba en test.spacepost.dev. El correo enviado a ellos no se entrega a ningún sitio, pero se ejecuta todo el flujo de eventos, incluidos los webhooks.

Dirección	Simula	Eventos que verás
delivered@test.spacepost.dev	Entrega correcta	email.sent, email.delivered
bounced@test.spacepost.dev	Rebote duro (permanente)	email.sent, email.bounced
complained@test.spacepost.dev	El destinatario lo marca como spam	email.sent, email.delivered, email.complained
delayed@test.spacepost.dev	Problema temporal de entrega	email.sent, email.delivery_delayed
softbounced@test.spacepost.dev	Rebote blando (buzón lleno); el tercero en 30 días suprime la dirección	email.sent, email.delivery_delayed

Sufijos de etiqueta

Añade +label para ejecutar varios escenarios en paralelo y distinguirlos: delivered+signup@test.spacepost.dev, bounced+case-17@test.spacepost.dev. El sufijo se ignora al elegir el resultado.

Precaución

Los rebotes duros y las quejas simulados se comportan como los reales: la dirección se añade a tu lista de supresión y cuenta para los umbrales de la pausa automática. Elimina las entradas de prueba desde Supresiones en el panel, o con DELETE /suppressions/{email}, después de ejecutar una prueba de rebote.

El remitente de prueba

Antes de verificar un dominio puedes enviar desde onboarding@test.spacepost.dev. Tiene restricciones:

• solo puede enviar a las direcciones de correo de los miembros de tu equipo y a direcciones @test.spacepost.dev;
• cualquier otro destinatario se rechaza con 403 validation_error;
• cuando tu dominio esté verificado, envía desde tu propia dirección.

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

Probar tu manejador de webhooks

1. Crea un webhook que apunte a un túnel hacia tu máquina (por ejemplo https://abc123.ngrok.app/webhooks/spacepost), suscrito a los eventos que gestionas.
2. Envía a delivered@, bounced@, complained@ y delayed@.
3. Comprueba que tu manejador verifica la firma y responde 2xx.

Los envíos de prueba cuentan para tu cuota mensual como cualquier otro correo.