API

Kokeile sandboxissa → Jokainen päätepiste, painikkeella, joka suorittaa sen reaaliaikaista palvelua vasten. Mikään täällä ei vaadi avainta, joten tältä sivulta lähettämäsi pyyntö on todellinen: se varaa todellisen osoitteen ja se lasketaan mukaan.

Kierto

Kaksi pyyntöä ja yksi sähköposti. Kolmas kutsu tarvitaan vain siksi, että analyysi kestää muutaman sekunnin.

1. Varaa osoite

   Lähetä POST-pyyntö inbox-päätepisteeseen. Saat osoitteen, joka hyväksyy täsmälleen yhden viestin ja vanhenee tunnissa, sekä tunnisteen, johon kaikki muu perustuu.

2. Lähetä oikea viesti siihen

   Lähetä se SMTP:n kautta alustalta, joka lähettää kampanjan. Puolet tarkistuksista lukee lähetysalustan lisäämiä otsakkeita, joten käsin laadittu viesti mittaa väärää asiaa.

3. Kysy tilaa ja lue sitten raportti

   Tilapäätepisteen vastaus on muutaman sadan tavun kokoinen ja kertoo, kannattaako koko raportti jo hakea. Itse raportti on useita tuhansia rivejä pitkä.

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

Todennus

Sitä ei ole. Ei pyydettävää avainta, asetettavaa otsaketta eikä luotavaa tiliä. Palautettu slug-tunniste toimii käyttöoikeutena: sen haltija voi lukea raportin, eivätkä muut voi arvata sitä.

Päätepisteet

Perusosoite https://email-spam-tester.com. Kaikki vastaukset ovat JSON-muodossa.

Raportin lukeminen

Vastauksen sisältävät kentät siinä järjestyksessä, jossa todennäköisesti haluat ne.

Tilat

Tarkistuksella on yksi viidestä tilasta, ja kahden niistä välinen ero on merkityksellisempi kuin miltä näyttää.

analysis_status voi olla received, analyzing, checks_ready tai failed. ai_status voi olla pending, running, ready, fallback tai error. Deterministinen raportti on lopullinen tilassa checks_ready; ai_status lisää vain suunnitelman.

Mitä voidaan palauttaa

Neljä tietämisen arvoista asiaa

Koneille

• /api/openapi.json OpenAPI-kuvaus, joka luodaan samasta APIa palvelevasta koodista.
• /llms.txt, /llms-full.txt Lyhyt kartta tästä sivustosta kielimalleille llms.txt-käytännön mukaisesti sekä pidempi versio, jossa koko kierros ja raportin kentät ovat yhdessä tiedostossa.
• /mcp MCP-palvelin, jolla on sama toiminnallisuus ja estävä odotus, mikä on parempi kuin kysely mallin sisältä.
• For agents Agenttisivu: milloin tätä kannattaa käyttää, miten ohitettua tarkistusta tulkitaan suhteessa läpäistyyn tarkistukseen ja mitkä havainnot ovat DNS-tietueita, jotka henkilön on muutettava, eivätkä tekstiä, jota agentti voi muokata.