API

Wypróbuj w środowisku testowym → Każdy endpoint ma przycisk, który uruchamia go w aktywnej usłudze. Nic tutaj nie wymaga klucza, więc żądanie wysłane z tej strony jest rzeczywiste: rezerwuje rzeczywisty adres i jest zliczane.

Cykl

Dwa żądania i jedna wiadomość e-mail. Trzecie wywołanie jest potrzebne tylko dlatego, że analiza trwa kilka sekund.

1. Zarezerwuj adres

   Wyślij żądanie POST do punktu końcowego skrzynki odbiorczej. Otrzymasz adres, który przyjmuje dokładnie jedną wiadomość i wygasa po godzinie, oraz identyfikator, z którym powiązane są wszystkie pozostałe dane.

2. Wyślij na niego rzeczywistą wiadomość

   Przez SMTP, z platformy, która wyśle kampanię. Połowa kontroli odczytuje nagłówki dodawane przez platformę wysyłającą, więc wiadomość utworzona ręcznie mierzy niewłaściwe rzeczy.

3. Odpytuj o status, a następnie odczytaj raport

   Punkt końcowy statusu zwraca kilkaset bajtów i informuje, czy warto już pobrać pełny raport. Sam raport ma kilka tysięcy wierszy.

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

Uwierzytelnianie

Nie ma żadnego. Nie trzeba uzyskiwać klucza, ustawiać nagłówka ani tworzyć konta. Zwrócony slug jest uprawnieniem: każdy, kto go posiada, może odczytać ten raport, a nikt inny nie może go odgadnąć.

Punkty końcowe

Adres bazowy https://email-spam-tester.com. Wszystko zwraca JSON.

Odczytywanie raportu

Pola zawierające odpowiedź, w kolejności, w której prawdopodobnie będą potrzebne.

Statusy

Test ma jeden z pięciu statusów, a różnica między dwoma z nich ma większe znaczenie, niż się wydaje.

analysis_status przyjmuje wartości received, analyzing, checks_ready, failed. ai_status przyjmuje wartości pending, running, ready, fallback, error. Raport deterministyczny jest ostateczny przy checks_ready; ai_status jedynie dodaje plan.

Co może zostać zwrócone

Cztery rzeczy, które warto wiedzieć

Dla maszyn

• /api/openapi.json Opis OpenAPI wygenerowany z tego samego kodu, który obsługuje API.
• /llms.txt, /llms-full.txt Krótka mapa tej witryny dla modeli językowych, zgodna z konwencją llms.txt, oraz dłuższa wersja z całym cyklem i polami raportu w jednym pliku.
• /mcp Serwer MCP o tych samych możliwościach i z oczekiwaniem blokującym, które jest lepsze niż odpytywanie z wnętrza modelu.
• For agents Strona dla agenta: kiedy z tego skorzystać, jak odróżnić pominiętą kontrolę od zakończonej powodzeniem i które ustalenia są rekordami DNS wymagającymi zmiany przez człowieka, a nie tekstem, który agent może edytować.