L'API

Provalo nella sandbox → Ogni endpoint, con un pulsante che lo esegue sul servizio attivo. Qui non serve alcuna chiave, quindi una richiesta inviata da questa pagina è reale: riserva un indirizzo reale e viene conteggiata.

Il ciclo

Due richieste e un'email. La terza chiamata serve solo perché l'analisi richiede alcuni secondi.

1. Riserva un indirizzo

   Invia una richiesta POST all'endpoint della casella di posta. Ricevi un indirizzo che accetta esattamente un messaggio e scade dopo un'ora, insieme allo slug su cui si basa tutto il resto.

2. Inviagli il messaggio reale

   Tramite SMTP, dalla piattaforma che invierà la campagna. Metà dei controlli legge le intestazioni aggiunte dalla piattaforma di invio, quindi un messaggio composto a mano misura la cosa sbagliata.

3. Interroga lo stato, quindi leggi il report

   L'endpoint di stato occupa poche centinaia di byte e indica se vale già la pena recuperare il report completo. Il report stesso si estende per diverse migliaia di righe.

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

Autenticazione

Non ce n'è. Nessuna chiave da richiedere, nessuna intestazione da impostare, nessun account da creare. Lo slug restituito è la capability: chiunque lo possieda può leggere quel report e nessun altro può indovinarlo.

Endpoint

Indirizzo base https://email-spam-tester.com. Tutto risponde in JSON.

Lettura del report

I campi che contengono la risposta, nell'ordine in cui probabilmente servono.

Stati

Un controllo può trovarsi in uno di cinque stati, e la differenza tra due di essi è più importante di quanto sembri.

analysis_status assume i valori received, analyzing, checks_ready, failed. ai_status assume i valori pending, running, ready, fallback, error. Il report deterministico è definitivo a checks_ready; ai_status aggiunge sempre e solo il piano.

Cosa può essere restituito

Quattro cose da sapere

Per le macchine

• /api/openapi.json La descrizione OpenAPI, generata dallo stesso codice che serve l'API.
• /llms.txt, /llms-full.txt Una breve mappa di questo sito per i modelli linguistici, secondo la convenzione llms.txt, e una versione più lunga con l'intero ciclo e i campi del report in un unico file.
• /mcp Un server MCP con la stessa funzionalità e un'attesa bloccante, che è preferibile al polling dall'interno di un modello.
• For agents La pagina per gli agenti: quando ricorrere a questo strumento, come interpretare un controllo ignorato rispetto a uno superato e quali risultati sono record DNS che una persona deve modificare anziché testo che un agente può modificare.