API

Vyzkoušet v sandboxu → Každý endpoint obsahuje tlačítko, které ho spustí proti živé službě. Nic zde nevyžaduje klíč, takže požadavek, který z této stránky odešlete, je skutečný: rezervuje skutečnou adresu a započítává se.

Postup

Dva požadavky a jeden e-mail. Třetí volání je potřeba jen proto, že analýza trvá několik sekund.

1. Rezervujte adresu

   Odešlete POST na koncový bod schránky. Získáte adresu, která přijme právě jednu zprávu a vyprší za hodinu, a také slug, podle kterého se identifikuje vše ostatní.

2. Odešlete na ni skutečnou zprávu

   Přes SMTP, z platformy, která bude kampaň odesílat. Polovina kontrol čte hlavičky přidané odesílací platformou, takže ručně vytvořená zpráva měří něco jiného.

3. Dotazujte se na stav a pak načtěte report

   Koncový bod stavu má několik set bajtů a sdělí vám, zda už má smysl načíst úplný report. Samotný report má několik tisíc řádků.

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

Ověřování

Žádné není. Není třeba žádat o klíč, nastavovat hlavičku ani vytvářet účet. Vrácený slug funguje jako přístupový údaj: kdokoli ho má, může daný report číst, a nikdo jiný ho nemůže uhodnout.

Koncové body

Základní adresa https://email-spam-tester.com. Vše vrací JSON.

Čtení reportu

Pole, která obsahují odpověď, v pořadí, v jakém je pravděpodobně budete potřebovat.

Stavy

Kontrola má jeden z pěti stavů a rozdíl mezi dvěma z nich je důležitější, než se zdá.

analysis_status nabývá hodnot received, analyzing, checks_ready, failed. ai_status nabývá hodnot pending, running, ready, fallback, error. Deterministický report je ve stavu checks_ready konečný; ai_status už pouze přidává plán.

Co může přijít v odpovědi

Čtyři důležité věci

Pro stroje

• /api/openapi.json Popis OpenAPI vygenerovaný ze stejného kódu, který obsluhuje API.
• /llms.txt, /llms-full.txt Krátká mapa tohoto webu pro jazykové modely podle konvence llms.txt a delší verze s celým cyklem a poli reportu v jednom souboru.
• /mcp Server MCP se stejnou funkcí a blokujícím čekáním, které je lepší než opakované dotazování zevnitř modelu.
• For agents Stránka pro agenty: kdy tuto funkci použít, jak rozlišit přeskočenou kontrolu od úspěšné a která zjištění jsou záznamy DNS, jež musí změnit člověk, nikoli text, který může upravit agent.