Spamkontroll-API for e-post,
innboks og domene

Hurtigstart

Tre kall. Ingen nøkkel, ingen konto, ingen registrering. 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.

   Forespørsel

   # 1. reserve a single-use address
   curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en'

   Svar

   {
     "address": "test-<slug>@t.email-spam-tester.com",
     "slug": "<slug>",
     "expires_at": "2026-01-01T12:00:00Z"
   }

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.

   Forespørsel

   # 2. send your message to that address, from your own platform
   To: test-<slug>@t.email-spam-tester.com

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.

   Forespørsel

   # 3. poll
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

   Svar

   {
     "slug": "<slug>",
     "analysis_status": "checks_ready",
     "ai_status": "running",
     "checks_done": 42,
     "checks_total": 42
   }

   Forespørsel

   # 4. read the report once analysis_status is checks_ready
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'

   Svar

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

Reserver en adresse, send meldingen du skulle til å sende til listen din, og les rapporten. Alt siden viser, finnes i JSON, inkludert poengsummen, alle de 42 kontrollene med dokumentasjonen deres og avsnittet i standarden som hvert funn bygger på.

De første 100 000 rapportene er gratis, uten nøkkel og uten konto. Hvis du setter opp en agent i stedet for et skript, passer MCP-serveren bedre enn polling.

Endepunkter

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

Hurtigstart

1. Opprett en test

   Send en POST-forespørsel til endepunktet for plassering. Du får tilbake en markør og testinnboksene.

   Forespørsel

   # 1. create a test
   curl -sX POST 'https://email-spam-tester.com/api/v1/placement' \
     -H 'Content-Type: application/json' \
     -d '{"public_results_accepted":true}'

   Svar

   {
     "slug": "<slug>",
     "marker": "est-3f9a1c7e2b4d6a80c5e1f2d3",
     "status": "waiting",
     "deadline": "2026-10-31T12:30:00Z",
     "poll_after_seconds": 60,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "pending", "observed_at": null}
     ],
     "fleet": {
       "status": "observing",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "pending", "coverage": "pending"}
       ]
     }
   }

2. Send én melding til hver innboks

   Legg markøren i emnefeltet, og send fra den vanlige plattformen din til alle adressene samtidig.

   Forespørsel

   # 2. one message to every address, with the marker in the subject
   Subject: October invoice est-3f9a1c7e2b4d6a80c5e1f2d3
   To: <seed>, <mailbox>, ...

3. Poll etter mappene

   Hver adresse fylles ut med leverandør og mappe. Poll til statusen ikke lenger er waiting.

   Forespørsel

   # 3. poll for the folders
   curl -s 'https://email-spam-tester.com/api/v1/placement/<slug>'

   Svar

   {
     "status": "complete",
     "received": 2,
     "total": 2,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "primary", "observed_at": "2026-10-31T12:04:11Z"},
       {"address": "<seed>", "provider": "gmail", "kind": "Google Workspace",
        "placement": "promotions", "observed_at": "2026-10-31T12:04:11Z"}
     ],
     "fleet": {
       "status": "finished",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "inbox", "coverage": "ok"},
         {"address": "<mailbox>", "provider": "outlook", "available": true,
          "placement": "spam", "coverage": "ok"}
       ]
     }
   }

Endepunkter

Hurtigstart

1. Gjør ett GET-kall

   Send med domenet. ip legger til senderadressene dine, og selector angir DKIM-selektorene som skal leses.

   Forespørsel

   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true'

2. Les resultatet

   ok er svaret for et skript, og sections viser hvilken del som mislyktes.

   Svar

   {
     "id": "ir_01JB8Y4T2M6K9QZ7H3V5N1XWDA",
     "domain": "example.com",
     "checked_at": "2026-10-31T12:00:00Z",
     "ok": false,
     "status": "fail",
     "score": 78,
     "coverage": {"answered": 7, "total": 8},
     "ips": [{"ip": "203.0.113.5", "sources": ["mx", "spf"], "managed": false}],
     "sections": {
       "dkim": {"status": "pass", "core": true, "findings": [], "data": {}},
       "ptr": {"status": "fail", "core": true, "findings": [], "data": {}}
     },
     "not_checked": [
       {"check": "dkim_signature", "reason": "needs_a_message"},
       {"check": "alignment", "reason": "needs_a_message"}
     ],
     "diff": {
       "baseline": {"id": "ir_01JB2...", "checked_at": "2026-10-24T12:00:00Z"},
       "first_run": false,
       "changed": true,
       "worsened": true,
       "status_from": "pass",
       "score_from": 100,
       "changes": [
         {"path": "dkim.key.mail.sha256", "section": "dkim", "kind": "removed",
          "severity": "critical", "effect": "worsened", "from": "9f2c...", "to": null}
       ],
       "not_compared": [
         {"path": "blocklist_ip.203.0.113.5.bl.spamcop.net.listed", "reason": "lookup_failed"}
       ]
     }
   }

3. Legg det i cron

   Med diff=true sammenlignes hver kjøring med den forrige, og jq gjør svaret om til en avslutningskode.

   Forespørsel

   # exits non-zero if the domain is broken or its setup changed
   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true' \
     | jq -e '.ok and (.diff.changed | not)'

Lese svaret

En fullført kontroll svarer med 200, og utfallet ligger i brødteksten. status er den dårligste statusen blant de obligatoriske delene: spf, dkim, dmarc, ptr, blocklist_ip, blocklist_domain, mx og smtp. unknown i en obligatorisk del regnes som warn. ok er true når status er pass eller warn. score går fra 0 til 100 for de obligatoriske delene som svarte, og er null når feil og unknown gjør at mindre enn halvparten av den relevante vekten gjenstår. mta_sts, tls_rpt, bimi, dnssec, dane, ns og registration rapporteres og sammenlignes, men de påvirker ikke ok eller score.

En del kan være pass, warn, fail, error (vi kunne ikke kontrollere), unknown (for lite grunnlag) eller skipped (gjelder ikke). skipped påvirker ikke resultatet, og årsaken står i not_checked. dkim_signature og alignment er alltid med, fordi de trenger en ekte melding.

Hva ip og selector endrer

PTR og blokklister gjelder adresser, så en kjøring trenger noen. Den bruker ip-verdiene du sender inn. Uten noen bruker den opptil fire fra MX-vertene dine og fra ip4:- og ip6:-termer med én adresse i SPF-oppføringen på rotnivå. Adresser som tilhører en kjent e-postleverandør, oppføres som managed og kontrolleres ikke, og hvis ingen adresser gjenstår, svarer ptr og blocklist_ip med skipped. En selector kan ikke leses fra DNS, så en kjøring prøver din, dem tidligere kjøringer har funnet, og en liste over vanlige navn. At ingenting blir funnet, beviser ingenting, og dkim svarer med unknown. Hvis du sender fra din egen server, oppgi begge.

Hva som er endret

Hver oppføring i diff.changes har en path, en kind (added, removed, changed), en severity (critical, warning, info) og en effect (worsened, improved, neutral). Bare critical og warning setter diff.changed, så en rotert DKIM-nøkkel med samme lengde, en ny MX-adresse eller et fornyet sertifikat gjør ikke at cron-linjen feiler. diff.worsened følger effect for enhver endring. Ved en første kjøring finnes det ingenting å sammenligne med, og diff.first_run angir dette.

En baseline er alltid en av dine egne kjøringer, så det skjuler ingenting hvis noen andre kontrollerer domenet mellom to av kjøringene dine. Alt vi ikke kunne lese denne gangen, legges i diff.not_compared med den sist kjente verdien bevart, noe som betyr at en endring gjort under et avbrudd vises når oppslaget virker igjen. En kjøring med en annen ip eller selector forblir i samme serie, og det den ikke spurte om, blir heller ikke sammenlignet.

Hvorfor en planlagt kontroll bør bruke en nøkkel

Uten en nøkkel tilhører historikken din en nøkkelbasert hash av IP-adressen din, så den avsluttes når adressen endres, og personer bak samme adresse deler den: En kjøring fra en kollega flytter baseline for deg. Med en personlig API-nøkkel i Authorization: Bearer følger historikken nøkkelen. Kjøringer med en nøkkel oppbevares i 365 dager og kan bare åpnes med den nøkkelen. Kjøringer uten nøkkel oppbevares i 30 dager og kan åpnes av alle som har ID-en deres.

6 forespørsler per minutt og 50 per dag per IP, eller 30 og 500 per nøkkel. Over dette svarer tjenesten med 429 og Retry-After. En identisk forespørsel innen 60 sekunder kommer fra en hurtigbuffer, merkes med cached: true, skriver ingen kjøring og teller ikke. Lesing av lagrede kjøringer tillater 120 forespørsler per minutt per klient. 503 med Retry-After betyr at for mange kontroller kjører, eller, ved lesing av lagrede kjøringer, at lagringen er utilgjengelig. 401 betyr feil nøkkel. 422 inneholder detail.code: invalid_domain, invalid_ip, invalid_selector, invalid_check, invalid_since, unknown_baseline eller account_required.

Endepunkter

Hurtigstart

1. Velg en kontroll

   Velg verktøyet fra listen nedenfor, og oppgi domenet, adressen eller IP-en det ber om.

   Forespørsel

   curl -s 'https://email-spam-tester.com/api/v1/tools/spf?domain=example.com'

2. Les status og funn

   Hvert verktøy svarer med en status og sine funn. Feltene etter disse avhenger av verktøyet.

   Svar

   {
     "tool": "spf",
     "query": {"domain": "example.com"},
     "checked_at": "2026-10-31T12:00:00Z",
     "duration_ms": 412,
     "status": "fail",
     "findings": [
       {"code": "spf.too_many_lookups", "level": "fail",
        "params": {"limit": 10, "count": 12},
        "message": "RFC 7208 §4.6.4 allows at most 10 DNS lookups, and this record needs 12, so receivers return permerror."}
     ],
     "record": "v=spf1 include:_spf.example.net ~all",
     "lookups": {"count": 12, "limit": 10, "void": 0}
   }

Endepunkter