Die API

In der Sandbox testen → Jeder Endpunkt mit einer Schaltfläche, die ihn im Live-Dienst ausführt. Hier ist kein Schlüssel erforderlich, daher ist eine Anfrage, die Sie von dieser Seite senden, eine echte Anfrage: Sie reserviert eine echte Adresse und wird gezählt.

Der Ablauf

Zwei Anfragen und eine E-Mail. Der dritte Aufruf ist nur erforderlich, weil die Analyse einige Sekunden dauert.

1. Eine Adresse reservieren

   Senden Sie eine POST-Anfrage an den Posteingangs-Endpunkt. Sie erhalten eine Adresse zurück, die genau eine Nachricht akzeptiert und nach einer Stunde abläuft, sowie den Slug, über den alles Weitere zugeordnet wird.

2. Die echte Nachricht dorthin senden

   Über SMTP, von der Plattform, die die Kampagne versenden wird. Die Hälfte der Prüfungen liest Header, die Ihre Versandplattform hinzufügt, daher misst eine manuell verfasste Nachricht das Falsche.

3. Den Status abfragen, dann den Bericht lesen

   Der Status-Endpunkt ist einige Hundert Byte groß und teilt Ihnen mit, ob es sich bereits lohnt, den vollständigen Bericht abzurufen. Der Bericht selbst umfasst mehrere Tausend Zeilen.

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

Authentifizierung

Es gibt keine. Kein Schlüssel muss angefordert, kein Header gesetzt und kein Konto erstellt werden. Der zurückgegebene Slug ist die Zugriffsberechtigung: Wer ihn besitzt, kann diesen Bericht lesen, und niemand sonst kann ihn erraten.

Endpunkte

Basisadresse https://email-spam-tester.com. Alles antwortet mit JSON.

Bericht lesen

Die Felder, die die Antwort enthalten, in der Reihenfolge, in der Sie sie wahrscheinlich benötigen.

Status

Eine Prüfung hat einen von fünf Status, und der Unterschied zwischen zweien davon ist wichtiger, als es scheint.

analysis_status durchläuft received, analyzing, checks_ready, failed. ai_status durchläuft pending, running, ready, fallback, error. Der deterministische Bericht ist bei checks_ready endgültig; ai_status fügt immer nur den Plan hinzu.

Was zurückkommen kann

Vier wissenswerte Dinge

Für Maschinen

• /api/openapi.json Die OpenAPI-Beschreibung, generiert aus demselben Code, der die API bereitstellt.
• /llms.txt, /llms-full.txt Eine kurze Übersicht dieser Website für Sprachmodelle gemäß der llms.txt-Konvention und eine längere Version mit dem gesamten Ablauf und den Berichtsfeldern in einer Datei.
• /mcp Ein MCP-Server mit derselben Funktion und blockierendem Warten, was besser ist als Polling aus einem Modell heraus.
• For agents Die Agentenseite: wann dies verwendet werden sollte, wie eine übersprungene Prüfung im Vergleich zu einer bestandenen zu lesen ist und bei welchen Ergebnissen es sich um DNS-Einträge handelt, die eine Person ändern muss, statt um Text, den ein Agent bearbeiten kann.