Validation API

API Validation pozwala weryfikować adresy email przed wysyłką by zmniejszyć odbicia i chronić reputację nadawcy.

Waliduj pojedynczy email

Waliduj pojedynczy adres email.

POST /v1/validate/single

Body żądania

Pole	Typ	Wymagane	Opis
email	string	Tak	Adres email do walidacji

Przykładowe żądanie

curl -X POST https://api.mailingapi.com/v1/validate/single \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

Odpowiedź

{
  "email": "user@example.com",
  "valid": true,
  "result": "deliverable",
  "checks": {
    "syntax": "valid",
    "dns": "valid",
    "mx": "valid",
    "disposable": false,
    "role": false,
    "catch_all": false,
    "smtp": "valid"
  },
  "suggestion": null
}

Typy wyników

Wynik	Opis	Akcja
deliverable	Skrzynka istnieje	Bezpiecznie wysłać
undeliverable	Skrzynka nie istnieje	Nie wysyłać
risky	Może odbić	Wysyłać z ostrożnością
unknown	Nie udało się zweryfikować	Ręczny przegląd

Pola sprawdzeń

Pole	Opis
syntax	Format emaila prawidłowy
dns	Domena ma rekordy DNS
mx	Domena ma rekordy MX
disposable	Tymczasowa usługa email
role	Adres generyczny (info@, admin@)
catch_all	Domena przyjmuje dowolny adres
smtp	Skrzynka istnieje (sprawdzenie SMTP)

---

Walidacja z sugestią literówki

Gdy walidacja wykryje możliwą literówkę:

{
  "email": "user@gmial.com",
  "valid": false,
  "result": "undeliverable",
  "suggestion": "user@gmail.com"
}

---

Walidacja masowa

Waliduj wiele emaili w jednym żądaniu. Wyniki zwracane synchronicznie.

POST /v1/validate/batch

Body żądania

Pole	Typ	Wymagane	Opis
emails	array	Tak	Lista emaili (max 10 000)

Przykładowe żądanie

curl -X POST https://api.mailingapi.com/v1/validate/batch \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "user1@example.com",
      "user2@example.com",
      "invalid@nieistniejaca.domena"
    ]
  }'

Odpowiedź

{
  "results": [
    {
      "email": "user1@example.com",
      "valid": true,
      "result": "deliverable",
      "checks": {
        "syntax": "valid",
        "dns": "valid",
        "mx": "valid",
        "disposable": false,
        "role": false
      }
    },
    {
      "email": "user2@example.com",
      "valid": true,
      "result": "deliverable",
      "checks": {
        "syntax": "valid",
        "dns": "valid",
        "mx": "valid",
        "disposable": false,
        "role": false
      }
    },
    {
      "email": "invalid@nieistniejaca.domena",
      "valid": false,
      "result": "undeliverable",
      "checks": {
        "syntax": "valid",
        "dns": "invalid",
        "mx": "invalid",
        "disposable": false,
        "role": false
      }
    }
  ],
  "summary": {
    "total": 3,
    "deliverable": 2,
    "undeliverable": 1,
    "risky": 0,
    "unknown": 0
  }
}

---

Kody błędów

Kod	Opis
invalid_email_format	Składnia emaila nieprawidłowa
job_not_found	ID zadania nie znalezione
file_too_large	Plik przekracza 100 MB
too_many_emails	Przekroczono limit 1 miliona
invalid_file_format	Niewspierany typ pliku
job_already_completed	Nie można anulować zakończonego zadania