APIを利用する

診断用アドレスの発行・診断結果の取得・削除をHTTP APIで実行できます。認証・APIキーは不要（結果へのアクセスはURLに含まれる推測不能な token のみで保護されます）。CORS許可済みのため、ブラウザ上のアプリやAIエージェントからも直接呼び出せます。

基本の流れ

1. 01アドレスを発行する (POST /api/new)
2. 02発行されたアドレスへメールを送信する
3. 03結果を取得する (GET /api/result/<token>)。受信までは "waiting" が返ります

エンドポイント

診断用アドレスを発行します（有効期限24時間）。

curl -X POST https://xmailtester.com/api/new

{
  "address": "t-xxxxxxxx@xmailtester.com",
  "url": "https://xmailtester.com/r/<token>",
  "expires_at": 1784800000000
}

レスポンスの url 末尾が token です。以降のAPIで使用します。

診断結果を取得します。未受信の間は "status": "waiting"。受信後は新しい順に最大10件の履歴を返します。

curl https://xmailtester.com/api/result/<token>

{
  "status": "done",
  "reports": [
    {
      "received_at": 1784800000000,
      "raw_url": "/api/raw/<token>/1784800000000",
      "report": {
        "score": 9.5,
        "checks": [
          { "id": "spf", "name": "なりすまし対策（SPF）", "status": "pass",
            "detail": "...", "advice": null },
          ...
        ],
        "gmail": { "personal": [...], "bulk": [...] },
        "tech": { "received": [...], "spamScore": 0, ... },
        "version": "2026-07-23.3"
      }
    }
  ],
  "address": "t-xxxxxxxx@xmailtester.com",
  "expires_at": 1784880000000
}

checks[].status は次の5値です。

値	意味
pass	合格
warn	注意（軽微な改善点あり）
fail	要対応
info	参考情報（減点なし）
skip	判定対象外

report に含まれる主な内容:

• checks[] — 各診断項目の判定・説明・改善ガイド。要対応項目には、実際の送信元情報から生成した設定案 fix（{label, records[{rrtype, name, value}], note}）が付くことがあります
• gmail.personal / gmail.bulk — Gmail送信者ガイドライン適合表。各行 {label, ok}（ok は true=満たす / false=満たさない / null=判定不可）
• tech — 主要ヘッダの抜粋（Received / Authentication-Results / DKIM-Signature / スパムスコア等）
• version — 診断エンジンのバージョン

受信メールの生データ（.eml）を取得します。<received_at> は結果APIの reports[].received_at（各エントリの raw_url をそのまま使えます）。<received_at> を省略すると最新の受信分を返します。

curl https://xmailtester.com/api/raw/<token>/1784800000000

診断データ（アドレス・結果・受信メール）を即時に完全削除します。取り消しはできません。

curl -X DELETE https://xmailtester.com/api/result/<token>

{ "deleted": true }

制限・データ保持

項目	内容
発行数	同一IPあたり20件/時（超過時は 429）
アドレス有効期限	発行から24時間・受信20通まで
診断履歴	アドレスごとに直近10件
データ保持	7日後に自動削除（DELETE で即時削除可）

仕様は予告なく変更される場合があります。大量利用・組み込み利用のご相談は運営まで。