API-et

Prøv det i sandkassen → Hvert endepunkt, med en knapp som kjører det mot den aktive tjenesten. Ingenting her krever en nøkkel, så en forespørsel du sender fra denne siden, er reell: Den reserverer en reell adresse og telles med.

Forløpet

To forespørsler og én e-post. Det tredje kallet er bare nødvendig fordi analysen tar noen sekunder.

1. Reserver en adresse

   Send en POST-forespørsel til innboks-endepunktet. Du får tilbake en adresse som godtar nøyaktig én melding og utløper etter en time, samt sluggen som alt annet identifiseres med.

2. Send den faktiske meldingen til den

   Over SMTP, fra plattformen som skal sende kampanjen. Halvparten av kontrollene leser meldingshoder som sendeplattformen din legger til, så en melding som er skrevet manuelt, måler feil ting.

3. Spør etter status, og les deretter rapporten

   Status-endepunktet er på noen hundre byte og forteller deg om det er verdt å hente hele rapporten ennå. Selve rapporten består av flere tusen 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"}}
  ]
}

Autentisering

Det finnes ingen. Ingen nøkkel å be om, ingen header å angi, ingen konto å opprette. Sluggen du får tilbake, er tilgangen: Den som har den, kan lese rapporten, og ingen andre kan gjette den.

Endepunkter

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

Lese rapporten

Feltene som inneholder svaret, i den rekkefølgen du sannsynligvis vil ha dem.

Statuser

En kontroll har én av fem statuser, og forskjellen mellom to av dem er viktigere enn den ser ut til.

analysis_status går gjennom received, analyzing, checks_ready, failed. ai_status går gjennom pending, running, ready, fallback, error. Den deterministiske rapporten er endelig ved checks_ready; ai_status legger bare til planen.

Hva som kan returneres

Fire ting det er verdt å vite

For maskiner

• /api/openapi.json OpenAPI-beskrivelsen, generert fra den samme koden som leverer API-et.
• /llms.txt, /llms-full.txt Et kort kart over dette nettstedet for språkmodeller, i llms.txt-konvensjonen, og en lengre versjon med hele forløpet og rapportfeltene i én fil.
• /mcp En MCP-server med samme funksjonalitet og blokkerende venting, som er bedre enn polling fra innsiden av en modell.
• For agents Agentsiden: når du bør bruke dette, hvordan du skiller en kontroll som ble hoppet over fra en som besto, og hvilke funn som er DNS-oppføringer en person må endre, i stedet for tekst en agent kan redigere.