Az API

Próbálja ki a sandboxban → Minden végpont egy gombbal, amely az élő szolgáltatáson futtatja. Itt semmihez sem szükséges kulcs, ezért az erről az oldalról indított kérés valódi: valódi címet foglal le, és beleszámít.

A folyamat

Két kérés és egy e-mail. A harmadik hívásra csak azért van szükség, mert az elemzés néhány másodpercig tart.

1. Foglalj le egy címet

   Küldj POST-kérést a beérkező levelek végpontjára. Válaszként kapsz egy címet, amely pontosan egy üzenetet fogad, és egy óra múlva lejár, valamint azt a slugot, amely minden további művelet kulcsa.

2. Küldd el rá a tényleges üzenetet

   SMTP-n keresztül, arról a platformról, amely a kampányt küldeni fogja. Az ellenőrzések fele a küldőplatform által hozzáadott fejléceket olvassa, ezért egy kézzel összeállított üzenet nem a megfelelő dolgot méri.

3. Kérdezd le az állapotot, majd olvasd el a jelentést

   Az állapotvégpont néhány száz bájtos, és megmondja, hogy érdemes-e már lekérni a teljes jelentést. Maga a jelentés több ezer soros.

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

Hitelesítés

Nincs. Nem kell kulcsot kérni, fejlécet beállítani vagy fiókot létrehozni. A visszakapott slug maga a hozzáférés: aki birtokolja, elolvashatja a jelentést, más pedig nem tudja kitalálni.

Végpontok

Alapcím: https://email-spam-tester.com. Minden válasz JSON.

A jelentés olvasása

A választ tartalmazó mezők, abban a sorrendben, amelyben valószínűleg szüksége lesz rájuk.

Állapotok

Egy ellenőrzés öt állapot egyikében lehet, és a közülük kettő közötti különbség fontosabb, mint amilyennek látszik.

Az analysis_status lehetséges értékei: received, analyzing, checks_ready, failed. Az ai_status lehetséges értékei: pending, running, ready, fallback, error. A determinisztikus jelentés a checks_ready állapotnál végleges; az ai_status csak a tervet adja hozzá.

Milyen válasz érkezhet

Négy fontos tudnivaló

Gépi használatra

• /api/openapi.json Az OpenAPI-leírás, amely ugyanabból a kódból készül, amely az API-t kiszolgálja.
• /llms.txt, /llms-full.txt Az oldal rövid térképe nyelvi modellek számára, az llms.txt konvenció szerint, valamint egy hosszabb változat, amely egyetlen fájlban tartalmazza a teljes ciklust és a jelentés mezőit.
• /mcp Egy azonos képességű, blokkoló várakozást biztosító MCP-kiszolgáló, amely jobb, mint a modellen belülről végzett lekérdezéses várakozás.
• For agents Az ügynökoldal: mikor érdemes ezt használni, hogyan kell értelmezni egy kihagyott ellenőrzést egy sikereshez képest, és mely megállapítások olyan DNS-rekordok, amelyeket egy személynek kell módosítania, nem pedig olyan szövegek, amelyeket egy ügynök szerkeszthet.