Proper Check

Послуга

API верифікації email

Підключіть форму реєстрації, SaaS або CRM. REST API з Bearer-ключем і документацією OpenAPI.

  • OpenAPI
  • API-ключі в панелі
  • Bulk і 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@company.com"}'

Навіщо API верифікації?

Real-time verification захищає форму signup від помилок, fake account і disposable email. База залишається чистою з першого дня.

Self-serve: створіть акаунт, завантажте список або підключіть API без sales call.

Основні endpoint

Авторизація заголовком Authorization: Bearer ev_live_…

  • POST /api/v1/verify - одна адреса
  • POST /api/v1/bulk - масив адрес
  • GET /api/v1/bulk/:id - статус job
  • GET /api/v1/credits - баланс кредитів

Керування ключами

Створюйте кілька API-токенів, ротуйте їх і вимикайте окремі ключі без впливу на решту інтеграції. Кожен ключ може обслуговувати окреме середовище: production, staging або bulk cron.

Латентність і таймаути

Типовий час відповіді — кілька секунд. Поштові сервери іноді відповідають повільно або застосовують greylisting — тоді статус може бути unknown. У формі signup показуйте spinner і не блокуйте користувача довше 8–10 с.

Коди помилок API

401 — відсутній або невірний токен. 402 — немає кредитів. 422 — невірний email у payload. 429 — rate limit. Повна специфікація в документації OpenAPI.

  • 401 Unauthorized — перевірте заголовок Authorization: Bearer
  • 402 Payment Required — поповніть кредити в панелі
  • 422 Unprocessable — виправте формат адреси в JSON
  1. Створіть токен

    Панель → API → згенеруйте Bearer-ключ.

  2. Викличте verify

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

  3. Обробіть результат

    Valid → збережіть ліда. Invalid → покажіть помилку у формі.

Очистили 40 тис. лідів перед cold email. Bounce впав з 9% до менше 1% — домен перестав потрапляти в спам.

Марта, B2B SaaSВерифікований клієнт

Щотижня завантажуємо CSV з CRM. Експорт зі статусами економить години ручної перевірки.

Томаш, outbound-агентствоВерифікований клієнт

Тестових кредитів вистачило на оцінку якості. Потім докупили пакет під B2B-розсилку.

Каміль, marketing automationВерифікований клієнт

Пов'язані

Часті запитання

Яка латентність API?

Зазвичай секунди. Залежить від поштового сервера одержувача та навантаження.

Що, якщо кредити закінчилися?

API повертає помилку 402. Поповніть кредити в панелі.

Чи можу тестувати API безкоштовно?

Після реєстрації ви отримуєте безкоштовні тестові кредити. Використайте їх на staging перед продакшеном.