API

サンドボックスで試す → すべてのエンドポイントに、ライブサービスに対して実行するボタンがあります。ここではキーは不要なので、このページから送信するリクエストは実際のものです。実際のアドレスを予約し、件数にカウントされます。

処理の流れ

2回のリクエストと1通のメール。3回目の呼び出しが必要なのは、分析に数秒かかるためです。

1. アドレスを予約

   inboxエンドポイントにPOSTします。正確に1通のメッセージだけを受信し、1時間で期限切れになるアドレスと、その他すべてのキーとなるスラッグが返されます。

2. 実際のメッセージをそこに送信

   キャンペーンを送信するプラットフォームから、SMTP経由で送信します。チェックの半数は送信プラットフォームが追加するヘッダーを確認するため、手作業で作成したメッセージでは誤った対象を測定することになります。

3. ステータスをポーリングしてからレポートを取得

   statusエンドポイントのレスポンスは数百バイトで、完全なレポートを取得する段階かどうかを確認できます。レポート自体は数千行に及びます。

# 1. reserve a single-use address
curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en'

{
  "address": "test-<slug>@t.email-spam-tester.com",
  "slug": "<slug>",
  "expires_at": "2026-01-01T12:00:00Z"
}

# 2. send your message to that address, then poll
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

{
  "slug": "<slug>",
  "analysis_status": "checks_ready",
  "ai_status": "running",
  "checks_done": 39,
  "checks_total": 39
}

# 3. read the report once analysis_status is checks_ready
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'

{
  "report_url": "https://email-spam-tester.com/t/<slug>",
  "score_ours": 86.4,
  "score_compat": 9.2,
  "subscores": {"auth": 100.0, "infra_spam": 78.1, "content": 92.0, "compliance": 75.0},
  "complete": true,
  "checks": [
    {
      "id": "auth.dmarc",
      "status": "warn",
      "title": "DMARC result",
      "summary": "DMARC passes, but the policy is p=none.",
      "weight_ours": -4.0,
      "evidence": {"policy": "none", "aligned": "dkim"},
      "citations": {"standards": [{"title": "RFC 9989 §4.7", "quote": "..."}]}
    }
  ],
  "fixes": [
    {"id": "dmarc-enforce", "gain_ours": 4.0, "gain_compat": 0.0,
     "fix": {"title": "Move DMARC to quarantine", "severity": "medium"}}
  ]
}

認証

ありません。要求するキーも、設定するヘッダーも、作成するアカウントもありません。返されるスラッグ自体がアクセス権です。それを保持する人は誰でもそのレポートを読むことができ、それ以外の人が推測することはできません。

エンドポイント

ベースアドレスは https://email-spam-tester.com です。すべてJSONで応答します。

レポートを読む

回答を含むフィールドを、おそらく必要になる順に示します。

ステータス

チェックには5つの状態があり、そのうち2つの違いは見た目以上に重要です。

analysis_statusはreceived、analyzing、checks_ready、failedの順に進みます。ai_statusはpending、running、ready、fallback、errorの順に進みます。確定的なレポートはchecks_readyの時点で最終版となり、ai_statusはプランを追加するだけです。

返される可能性があるもの

知っておくべき4つのこと

マシン向け

• /api/openapi.json APIを提供するものと同じコードから生成されたOpenAPI記述。
• /llms.txt, /llms-full.txt 言語モデル向けのこのサイトの短いマップ（llms.txt規約に準拠）と、ループ全体およびレポートのフィールドを1つのファイルに収めた長いバージョン。
• /mcp 同じ機能とブロッキング待機を備えたMCPサーバー。モデル内からポーリングするより優れています。
• For agents エージェント向けページ：これを使う場面、スキップされたチェックと合格したチェックの読み分け方、エージェントが編集できるテキストではなく人が変更する必要があるDNSレコードに該当する検出結果。