API'et

Prøv det i sandkassen → Hvert endpoint har en knap, der kører det mod live-tjenesten. Intet her kræver en nøgle, så en anmodning, du sender fra denne side, er reel: Den reserverer en rigtig adresse, og den tæller med.

Forløbet

To forespørgsler og én email. Det tredje kald er kun nødvendigt, fordi analysen tager nogle få sekunder.

1. Reservér en adresse

   Send en POST-anmodning til indbakke-endpointet. Du får en adresse tilbage, som accepterer præcis én meddelelse og udløber efter en time, samt den slug, som alt andet bruger som nøgle.

2. Send den rigtige meddelelse til den

   Via SMTP fra den platform, der skal sende kampagnen. Halvdelen af kontrollerne læser headere, som din afsendelsesplatform tilføjer, så en meddelelse, der er skrevet manuelt, måler det forkerte.

3. Poll status, og læs derefter rapporten

   Status-endpointet fylder nogle få hundrede byte og fortæller dig, om det er værd at hente hele rapporten endnu. Selve rapporten fylder flere tusinde linjer.

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

Godkendelse

Der er ingen. Ingen nøgle at anmode om, ingen header at angive, ingen konto at oprette. Den slug, du får tilbage, er adgangsmuligheden: Den, der har den, kan læse rapporten, og ingen andre kan gætte den.

Endpoints

Basisadresse https://email-spam-tester.com. Alt svarer med JSON.

Læsning af rapporten

Felterne, der indeholder svaret, i den rækkefølge, du sandsynligvis ønsker dem.

Statusser

En kontrol har én af fem statusser, og forskellen mellem to af dem betyder mere, end det ser ud til.

analysis_status gennemgår received, analyzing, checks_ready, failed. ai_status gennemgår pending, running, ready, fallback, error. Den deterministiske rapport er endelig ved checks_ready; ai_status tilføjer altid kun planen.

Hvad der kan returneres

Fire ting, der er værd at vide

Til maskiner

• /api/openapi.json OpenAPI-beskrivelsen, genereret ud fra den samme kode, som leverer API'et.
• /llms.txt, /llms-full.txt Et kort kort over dette websted til sprogmodeller, i llms.txt-konventionen, og en længere version med hele forløbet og rapportfelterne i én fil.
• /mcp En MCP-server med samme funktionalitet og en blokerende ventefunktion, som er bedre end polling inde fra en model.
• For agents Agentsiden: hvornår dette skal bruges, hvordan en sprunget kontrol skal læses i forhold til en bestået, og hvilke resultater der er DNS-poster, som en person skal ændre, frem for tekst, som en agent kan redigere.