テスト

実在するドメインの架空のアドレスでテストするのは避けてください。バウンスして、送信者の評判を損ないます。SpacePost は test.spacepost.dev にテスト用の受信箱を用意しています。これらへのメールはどこにも配信されませんが、Webhook を含むイベントの一連の処理はすべて実行されます。

アドレス	シミュレートする内容	確認できるイベント
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 日以内に 3 回目が発生すると、そのアドレスは送信停止になります	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>"
  }'

Webhook ハンドラーをテストする

1. お使いのマシンへのトンネル（たとえば https://abc123.ngrok.app/webhooks/spacepost）を指す Webhook を作成し、処理するイベントを購読します。
2. delivered@、bounced@、complained@、delayed@ に送信します。
3. ハンドラーが署名を検証し、2xx を返すことを確認します。

テスト送信も、他のメールと同様に月間クォータに加算されます。