APIを利用する

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

基本の流れ

1. アドレスを発行 → 2. 発行されたアドレスへメールを送信 → 3. 結果を取得（受信まで数秒〜。届くまでは 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,
   "report":{"score":9.5,"checks":[
     {"id":"spf","name":"なりすまし対策（SPF）","status":"pass",
      "detail":"...","advice":null}, ...]}}],
 "address":"t-xxxxxxxx@xmailtester.com","expires_at":...}

checks[].status は pass / warn / fail / info / skip の5値です。report には Gmail送信者ガイドライン適合表（gmail.personal / gmail.bulk、各行 {label, ok}。okは true=満たす / false=満たさない / null=判定不可）、主要ヘッダの抜粋（tech: received / authenticationResults / dkimSignatures / arc / messageId / date / spamScore）、診断エンジンのバージョン（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}

制限・データ保持

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