SPF CheckerDKIM CheckerDMARC CheckerBlacklistHTML CheckerDNS GeneratorBlog
REST API v1

🔌 API dla deweloperów

Sprawdzaj SPF, DKIM, DMARC i blacklisty programowo. 100 zapytań dziennie za darmo, bez karty kredytowej.

🗝️

Wygeneruj klucz API

Klucz Free jest bezpłatny na zawsze — 100 zapytań/dzień, bez karty kredytowej.

✅ Twój klucz API:

Zachowaj go w bezpiecznym miejscu. Nie udostępniaj go nikomu.

Szybki start

Podstawowy URL API: https://spamtest.pl/api/v1/

Uwierzytelnianie — nagłówek lub query param:

# Nagłówek HTTP (zalecane)
X-Api-Key: spmt_twoj_klucz

# Alternatywnie — query parameter
?api_key=spmt_twoj_klucz

Przykład — sprawdź SPF:

curl -H "X-Api-Key: spmt_TWOJ_KLUCZ" \
  "https://spamtest.pl/api/v1/spf?domain=twojadomena.pl"
📡

Endpointy

GET/api/v1/spf
Sprawdza rekord SPF dla domeny. Zwraca pełną analizę mechanizmów i liczby lookupów.
domainwymaganyNazwa domeny (np. example.com)
curl -H "X-Api-Key: spmt_..." "https://spamtest.pl/api/v1/spf?domain=example.com"

// Odpowiedź
{
  "domain": "example.com",
  "valid": true,
  "record": "v=spf1 include:_spf.google.com ~all",
  "all": "~all",
  "lookups": 1,
  "lookup_ok": true,
  "mechanisms": [{ "type": "include", "value": "_spf.google.com" }]
}
GET/api/v1/dkim
Weryfikuje rekord DKIM dla podanego selektora.
domainwymaganyNazwa domeny
selectorwymaganySelektor DKIM (np. google, s1, mail)
curl -H "X-Api-Key: spmt_..." \
  "https://spamtest.pl/api/v1/dkim?domain=example.com&selector=google"

{
  "valid": true,
  "key_type": "rsa",
  "key_length_approx": 256
}
GET/api/v1/dmarc
Analizuje politykę DMARC domeny.
domainwymaganyNazwa domeny
curl -H "X-Api-Key: spmt_..." "https://spamtest.pl/api/v1/dmarc?domain=example.com"

{
  "valid": true,
  "policy": "reject",
  "pct": 100,
  "rua": "dmarc@example.com",
  "score": "strict"
}
GET/api/v1/blacklist
Sprawdza czy IP lub domena figuruje na czarnych listach (DNSBL).
qwymaganyAdres IP lub nazwa domeny
curl -H "X-Api-Key: spmt_..." "https://spamtest.pl/api/v1/blacklist?q=8.8.8.8"

{
  "query": "8.8.8.8",
  "type": "ip",
  "clean": true,
  "listed_count": 0,
  "results": [{ "list": "zen.spamhaus.org", "listed": false }]
}
POST/api/v1/html
Sprawdza zgodność szablonu email HTML z klientami pocztowymi (15+ reguł).
htmlwymaganyTreść HTML emaila (application/json body)
curl -X POST "https://spamtest.pl/api/v1/html" \
  -H "X-Api-Key: spmt_..." \
  -H "Content-Type: application/json" \
  -d '{"html":"..."}'

{
  "valid": false,
  "score": 70,
  "size_kb": 12,
  "issues": [{ "id": "flexbox", "msg": "Użyto Flexbox" }],
  "summary": { "errors": 1, "warnings": 2, "passed": 12 }
}
GET/api/v1/status
Sprawdza limit i użycie klucza API.
curl -H "X-Api-Key: spmt_..." "https://spamtest.pl/api/v1/status"

{
  "plan": "free",
  "limits": { "day": 100, "month": 2000 },
  "usage": { "today": 12, "this_month": 145 },
  "remaining": { "today": 88, "this_month": 1855 }
}
💎

Plany

Free
0 zł/miesiąc
  • 100 zapytań / dzień
  • 2 000 zapytań / miesiąc
  • 5 endpointów API
  • JSON responses
  • Bez rejestracji
Pro
Wkrótce
  • 5 000 zapytań / dzień
  • 100 000 zapytań / miesiąc
  • Priorytetowa obsługa DNS
  • Webhook powiadomienia
  • SLA 99.9%
⚠️

Kody błędów

KodOpis
200 OKSukces
400 Bad RequestBrakujący lub nieprawidłowy parametr
401 UnauthorizedBrak lub nieprawidłowy klucz API
429 Too Many RequestsPrzekroczono limit dzienny/miesięczny
500 Internal ErrorBłąd serwera (np. DNS timeout)