Sprawdzaj SPF, DKIM, DMARC i blacklisty programowo. 100 zapytań dziennie za darmo, bez karty kredytowej.
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.
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"
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" }] }
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 }
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" }
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 }] }
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 } }
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 } }
| Kod | Opis |
|---|---|
200 OK | Sukces |
400 Bad Request | Brakujący lub nieprawidłowy parametr |
401 Unauthorized | Brak lub nieprawidłowy klucz API |
429 Too Many Requests | Przekroczono limit dzienny/miesięczny |
500 Internal Error | Błąd serwera (np. DNS timeout) |