API:et

Prova i sandlådan → Varje endpoint, med en knapp som kör den mot den aktiva tjänsten. Inget här kräver en nyckel, så en begäran som du skickar från den här sidan är verklig: den reserverar en riktig adress och räknas.

Flödet

Två begäranden och ett e-postmeddelande. Det tredje anropet behövs bara eftersom analysen tar några sekunder.

1. Reservera en adress

   Skicka POST till inkorgens slutpunkt. Du får tillbaka en adress som tar emot exakt ett meddelande och upphör att gälla efter en timme, samt den slug som allt annat är kopplat till.

2. Skicka det riktiga meddelandet till den

   Via SMTP, från plattformen som ska skicka kampanjen. Hälften av kontrollerna läser huvuden som din sändningsplattform lägger till, så ett manuellt skapat meddelande mäter fel sak.

3. Avfråga statusen och läs sedan rapporten

   Statusslutpunkten omfattar några hundra byte och talar om huruvida det är värt att hämta hela rapporten ännu. Själva rapporten omfattar flera tusen rader.

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

Autentisering

Det finns ingen. Ingen nyckel att begära, inget huvud att ange, inget konto att skapa. Sluggen du får tillbaka är behörigheten: den som har den kan läsa rapporten, och ingen annan kan gissa den.

Ändpunkter

Basadress https://email-spam-tester.com. Allt svarar med JSON.

Läsa rapporten

Fälten som innehåller svaret, i den ordning du troligen vill ha dem.

Statusar

En kontroll kan vara en av fem saker, och skillnaden mellan två av dem är viktigare än den ser ut.

analysis_status går igenom received, analyzing, checks_ready, failed. ai_status går igenom pending, running, ready, fallback, error. Den deterministiska rapporten är slutgiltig vid checks_ready; ai_status lägger endast till planen.

Vad som kan returneras

Fyra saker som är bra att känna till

För maskiner

• /api/openapi.json OpenAPI-beskrivningen, genererad från samma kod som tillhandahåller API:et.
• /llms.txt, /llms-full.txt En kort karta över den här webbplatsen för språkmodeller, enligt llms.txt-konventionen, och en längre version med hela flödet och rapportfälten i en fil.
• /mcp En MCP-server med samma funktion och en blockerande väntan, vilket är bättre än att göra polling inifrån en modell.
• For agents Agentsidan: när detta ska användas, hur en överhoppad kontroll ska jämföras med en godkänd och vilka resultat som är DNS-poster som en person måste ändra snarare än text som en agent kan redigera.