API

Coba di sandbox → Setiap endpoint, dengan tombol yang menjalankannya pada layanan aktif. Tidak ada yang memerlukan kunci di sini, jadi permintaan yang Anda kirim dari halaman ini adalah permintaan nyata: permintaan tersebut mencadangkan alamat nyata dan dihitung.

Alur

Dua permintaan dan satu email. Panggilan ketiga hanya diperlukan karena analisis memerlukan waktu beberapa detik.

1. Pesan alamat

   Kirim POST ke endpoint kotak masuk. Anda akan menerima alamat yang menerima tepat satu pesan dan kedaluwarsa dalam satu jam, beserta slug yang menjadi kunci untuk semua hal lainnya.

2. Kirim pesan asli ke alamat tersebut

   Melalui SMTP, dari platform yang akan mengirim kampanye. Separuh pemeriksaan membaca header yang ditambahkan platform pengiriman Anda, sehingga pesan yang dibuat secara manual mengukur hal yang salah.

3. Lakukan polling status, lalu baca laporan

   Endpoint status berukuran beberapa ratus byte dan memberi tahu Anda apakah laporan lengkap sudah layak diambil. Laporan itu sendiri terdiri dari beberapa ribu baris.

# 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"}}
  ]
}

Autentikasi

Tidak ada. Tidak ada kunci yang perlu diminta, tidak ada header yang perlu ditetapkan, tidak ada akun yang perlu dibuat. Slug yang Anda terima adalah kapabilitasnya: siapa pun yang memilikinya dapat membaca laporan tersebut, dan tidak ada orang lain yang dapat menebaknya.

Endpoint

Alamat dasar https://email-spam-tester.com. Semuanya merespons dengan JSON.

Membaca laporan

Bidang yang memuat jawaban, dalam urutan yang mungkin Anda inginkan.

Status

Sebuah pemeriksaan memiliki satu dari lima status, dan perbedaan antara dua di antaranya lebih penting daripada yang terlihat.

analysis_status menjalankan received, analyzing, checks_ready, failed. ai_status menjalankan pending, running, ready, fallback, error. Laporan deterministik bersifat final pada checks_ready; ai_status hanya menambahkan rencana.

Respons yang mungkin diterima

Empat hal yang perlu diketahui

Untuk mesin

• /api/openapi.json Deskripsi OpenAPI, yang dihasilkan dari kode yang sama dengan yang melayani API.
• /llms.txt, /llms-full.txt Peta singkat situs ini untuk model bahasa, dalam konvensi llms.txt, dan versi yang lebih panjang dengan seluruh alur dan kolom laporan dalam satu file.
• /mcp Server MCP dengan kemampuan yang sama dan mekanisme tunggu yang memblokir, yang lebih baik daripada polling dari dalam model.
• For agents Halaman agen: kapan menggunakannya, cara membedakan pemeriksaan yang dilewati dari pemeriksaan yang lulus, dan temuan mana yang merupakan catatan DNS yang harus diubah oleh seseorang, bukan teks yang dapat diedit oleh agen.