API-ul

Încearcă în sandbox → Fiecare endpoint, cu un buton care îl rulează pe serviciul live. Nimic de aici nu necesită o cheie, așadar o solicitare pe care o trimiți de pe această pagină este una reală: rezervă o adresă reală și este contorizată.

Bucla

Două cereri și un e-mail. Al treilea apel există doar pentru că analiza durează câteva secunde.

1. Rezervă o adresă

   Trimite o cerere POST către endpointul inbox. Primești o adresă care acceptă exact un mesaj și expiră într-o oră, împreună cu identificatorul slug pe baza căruia este indexat tot restul.

2. Trimite-i mesajul real

   Prin SMTP, de pe platforma care va trimite campania. Jumătate dintre verificări citesc anteturile adăugate de platforma de trimitere, astfel încât un mesaj compus manual măsoară altceva.

3. Interoghează starea, apoi citește raportul

   Endpointul de stare are câteva sute de octeți și îți spune dacă merită să preiei deja raportul complet. Raportul propriu-zis are câteva mii de linii.

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

Autentificare

Nu există. Nicio cheie de solicitat, niciun antet de setat, niciun cont de creat. Slugul pe care îl primiți este capabilitatea: oricine îl deține poate citi raportul respectiv și nimeni altcineva nu îl poate ghici.

Endpointuri

Adresa de bază https://email-spam-tester.com. Totul răspunde cu JSON.

Citirea raportului

Câmpurile care conțin răspunsul, în ordinea în care probabil le doriți.

Stări

O verificare are una dintre cinci stări, iar diferența dintre două dintre ele contează mai mult decât pare.

analysis_status trece prin received, analyzing, checks_ready, failed. ai_status trece prin pending, running, ready, fallback, error. Raportul determinist este final la checks_ready; ai_status doar adaugă planul.

Ce poate fi returnat

Patru lucruri de știut

Pentru sisteme automate

• /api/openapi.json Descrierea OpenAPI, generată din același cod care deservește API-ul.
• /llms.txt, /llms-full.txt O hartă scurtă a acestui site pentru modelele lingvistice, conform convenției llms.txt, și o versiune mai lungă cu întreaga buclă și câmpurile raportului într-un singur fișier.
• /mcp Un server MCP cu aceeași funcționalitate și o așteptare blocantă, care este mai eficientă decât interogarea repetată din interiorul unui model.
• For agents Pagina pentru agenți: când să folosești acest instrument, cum să interpretezi o verificare omisă în raport cu una reușită și care constatări sunt înregistrări DNS pe care trebuie să le modifice o persoană, nu text pe care îl poate edita un agent.