테스트

실제 도메인의 임의 주소로 테스트하지 마세요. 반송되어 발신자 평판이 나빠집니다. SpacePost는 test.spacepost.dev에 테스트 수신함을 제공합니다. 이 주소로 보낸 메일은 어디에도 전달되지 않지만, 웹훅을 포함한 전체 이벤트 파이프라인이 동작합니다.

주소	시뮬레이션	확인할 수 있는 이벤트
delivered@test.spacepost.dev	전달 성공	email.sent, email.delivered
bounced@test.spacepost.dev	하드 반송(영구)	email.sent, email.bounced
complained@test.spacepost.dev	수신자가 스팸으로 신고	email.sent, email.delivered, email.complained
delayed@test.spacepost.dev	일시적인 전달 문제	email.sent, email.delivery_delayed
softbounced@test.spacepost.dev	소프트 반송(사서함 가득 참). 30일 안에 세 번째가 발생하면 주소가 발송 제외 처리됩니다	email.sent, email.delivery_delayed

라벨

+label을 붙이면 여러 시나리오를 병렬로 실행하고 구분할 수 있습니다. 예: delivered+signup@test.spacepost.dev, bounced+case-17@test.spacepost.dev. 결과를 결정할 때 라벨은 무시됩니다.

주의

시뮬레이션한 하드 반송과 스팸 신고도 실제와 똑같이 동작합니다. 주소가 발송 제외 목록에 추가되고 자동 일시 중지 기준에도 반영됩니다. 반송 테스트를 한 뒤에는 대시보드의 발송 제외에서, 또는 DELETE /suppressions/{email}로 테스트 항목을 삭제하세요.

테스트 발신자

도메인을 확인하기 전에는 **onboarding@test.spacepost.dev**로 보낼 수 있습니다. 이 발신자에는 제한이 있습니다.

• 내 팀 멤버의 이메일 주소와 @test.spacepost.dev 주소로만 보낼 수 있습니다.
• 그 밖의 수신자는 403 validation_error로 거부됩니다.
• 도메인이 확인되면 내 주소로 보내세요.

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

웹훅 핸들러 테스트하기

1. 내 컴퓨터로 연결되는 터널(예: https://abc123.ngrok.app/webhooks/spacepost)을 가리키는 웹훅을 만들고, 처리하는 이벤트를 구독하세요.
2. delivered@, bounced@, complained@, delayed@로 보냅니다.
3. 핸들러가 서명을 검증하고 2xx로 응답하는지 확인하세요.

테스트 발송도 다른 이메일과 마찬가지로 월 할당량에 포함됩니다.