Proper Check

Usługa

API weryfikacji email

Podłącz formularz rejestracji, SaaS lub CRM. REST API z kluczem Bearer i dokumentacją OpenAPI.

  • OpenAPI
  • Klucze API w panelu
  • Bulk i single endpoint
REST · POST /api/v1/verify
curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@firma.pl"}'

Po co API weryfikacji?

Real-time verification chroni formularz signup przed literówkami, fake accountami i disposable email. Baza pozostaje czysta od pierwszego dnia.

Self-serve: załóż konto, wgraj listę lub podłącz API bez rozmowy z handlowcem.

Główne endpointy

Autoryzacja nagłówkiem Authorization: Bearer ev_live_…

  • POST /api/v1/verify - pojedynczy adres
  • POST /api/v1/bulk - tablica adresów
  • GET /api/v1/bulk/:id - status joba
  • GET /api/v1/credits - saldo kredytów

Zarządzanie kluczami

Twórz wiele tokenów API, rotuj je i wyłączaj pojedyncze klucze bez wpływu na resztę integracji. Każdy klucz może służyć innemu środowisku: produkcja, staging, cron bulk.

Latencja i timeouty

Typowy czas odpowiedzi to kilka sekund. Serwery pocztowe czasem odpowiadają wolno lub blokują greylisting — wtedy status może być unknown. W formularzu signup warto pokazać spinner i nie blokować użytkownika na dłużej niż 8–10 s.

Kody błędów API

401 — brak lub nieprawidłowy token. 402 — brak kredytów. 422 — niepoprawny email w payloadzie. 429 — limit rate. Pełna specyfikacja w dokumentacji OpenAPI.

  • 401 Unauthorized — sprawdź nagłówek Authorization: Bearer
  • 402 Payment Required — doładuj kredyty w panelu
  • 422 Unprocessable — popraw format adresu w JSON
  1. Utwórz token

    Panel → API → wygeneruj klucz Bearer.

  2. Wywołaj verify

    POST z JSON {"email":"user@firma.pl"}.

  3. Obsłuż wynik

    Valid → zapisz lead. Invalid → pokaż błąd w formularzu.

Wyczyściliśmy 40 tys. leadów przed cold emailem. Bounce spadł z 9% do poniżej 1% — domena przestała wpadać w spam.

Marta, B2B SaaSZweryfikowany klient

Wgrywamy CSV z CRM raz w tygodniu. Eksport z statusami oszczędza nam godziny ręcznego sprawdzania.

Tomasz, agencja outboundZweryfikowany klient

Testowe kredyty wystarczyły, żeby ocenić jakość. Potem dokupiliśmy pakiet pod newsletter B2B.

Kamil, marketing automationZweryfikowany klient

Powiązane

Najczęstsze pytania

Jaka jest latencja API?

Typowo sekundy. Zależy od serwera pocztowego odbiorcy i obciążenia.

Co gdy skończą się kredyty?

API zwraca błąd 402. Doładuj kredyty w panelu.

Czy mogę testować API bez opłat?

Po rejestracji dostajesz darmowe kredyty testowe. Użyj ich na staging przed produkcją.