De API

Probeer het in de sandbox → Elk endpoint, met een knop die het uitvoert op de live service. Hiervoor is geen sleutel nodig, dus een verzoek dat je vanaf deze pagina verstuurt is echt: het reserveert een echt adres en telt mee.

De cyclus

Twee verzoeken en één e-mail. De derde aanroep is alleen nodig omdat de analyse enkele seconden duurt.

1. Reserveer een adres

   Stuur een POST-verzoek naar het inbox-endpoint. Je krijgt een adres terug dat precies één bericht accepteert en na een uur verloopt, plus de slug waaraan al het andere is gekoppeld.

2. Stuur het echte bericht ernaartoe

   Via SMTP, vanaf het platform dat de campagne zal verzenden. De helft van de controles leest headers die je verzendplatform toevoegt, dus een handmatig opgesteld bericht meet het verkeerde.

3. Poll de status en lees daarna het rapport

   Het status-endpoint is enkele honderden bytes groot en vertelt je of het volledige rapport al kan worden opgehaald. Het rapport zelf beslaat enkele duizenden regels.

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

Authenticatie

Die is er niet. Geen sleutel om aan te vragen, geen header om in te stellen, geen account om aan te maken. De slug die je terugkrijgt is de toegang: wie deze bezit, kan dat rapport lezen, en niemand anders kan deze raden.

Endpoints

Basisadres https://email-spam-tester.com. Alles retourneert JSON.

Het rapport lezen

De velden die het antwoord bevatten, in de volgorde waarin u ze waarschijnlijk wilt lezen.

Statussen

Een controle is een van vijf dingen, en het verschil tussen twee ervan is belangrijker dan het lijkt.

analysis_status doorloopt received, analyzing, checks_ready, failed. ai_status doorloopt pending, running, ready, fallback, error. Het deterministische rapport is definitief bij checks_ready; ai_status voegt alleen het plan toe.

Wat kan worden teruggegeven

Vier dingen om te weten

Voor machines

• /api/openapi.json De OpenAPI-beschrijving, gegenereerd op basis van dezelfde code die de API uitvoert.
• /llms.txt, /llms-full.txt Een korte kaart van deze site voor taalmodellen, volgens de llms.txt-conventie, en een langere versie met de volledige cyclus en de rapportvelden in één bestand.
• /mcp Een MCP-server met dezelfde functionaliteit en een blokkerende wachtfunctie, wat beter werkt dan pollen vanuit een model.
• For agents De agentpagina: wanneer je dit gebruikt, hoe je een overgeslagen controle ten opzichte van een geslaagde controle interpreteert, en welke bevindingen DNS-records zijn die een persoon moet wijzigen in plaats van tekst die een agent kan bewerken.