Proper Check
Центр разработчика · REST API v1

API верификации email-адресов

Проверяйте рассылки программно — меньше bounce, лучшая доставляемость

Подключите формы регистрации, CRM и лендинги к EmailVerifier. Проверяйте email через REST API в реальном времени или bulk job — прозрачная модель 1 request = 1 credit.

  • Верификация в реальном времени
  • Bulk до 50 000 email
  • 1 запрос = 1 кредит
Сгенерировать API-ключСоздать аккаунтOpenAPI / Redoc

Пример запроса

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_…" \
  -d '{"email":"user@company.com"}'

База знаний API

Выберите тему — от авторизации и кредитов до bulk, webhooks и кодов ошибок.

APIAPI верификации email

POST /verify — один адрес, результат за секунду, статус valid/invalid/risky.

Подробнее
APIBulk верификация email

Массовая проверка CSV — очередь job, polling прогресса и экспорт CSV.

Подробнее
APIКредиты и биллинг

Баланс, использование API, 1 credit = 1 верификация, обработка HTTP 402.

Подробнее
APIAPI-ключи и авторизация

Bearer ev_live_, панель токенов, безопасное хранение ключа.

Подробнее
APIWebhooks и интеграции

verification.completed, HMAC-подпись, CRM и маркетинговая автоматизация.

Подробнее
APIСправочник OpenAPI

Полная YAML-спецификация, Redoc UI и каталог HTTP-ошибок.

Подробнее

Что такое API верификации email?

REST-интерфейс для валидации адресов перед рассылкой.

API верификации email проверяет, существует ли адрес, принимает ли домен почту и не является ли ящик disposable или catch-all. Вы снижаете bounce rate, защищаете репутацию отправителя и улучшаете доставляемость.

API доступен по HTTPS на /api/v1. Авторизация — Bearer-ключ (ev_live_…) или сессия панели. Каждый успешный POST /verify стоит один credit — без подписки и скрытых платежей за GET.

Когда использовать API валидатора email

Типичные сценарии интеграции в B2B-продуктах и маркетинговых стеках.

Формы регистрации

Валидируйте email в реальном времени при регистрации — отклоняйте invalid и disposable до добавления в список.

CRM и захват лидов

Очищайте лиды с лендингов и webhooks — в pipeline попадают только доставляемые адреса.

Гигиена списков перед кампаниями

Bulk API перед newsletter — меньше отказов, выше open rate и ниже стоимость ESP.

SaaS-платформы

Встройте проверку email в продукт — кредитная модель упрощает ценообразование для клиентов.

Кредитная модель API

Простое ценообразование: один запрос верификации = один credit.

  • POST /verify списывает 1 credit за каждый успешный запрос (HTTP 200) с ключом ev_live_, даже если адрес уже проверялся через API. Sandbox-ключи (ev_test_) возвращают mock без списания кредитов.
  • GET-операции — баланс, история, статус bulk job, экспорт CSV — бесплатны.
  • Недостаточный баланс возвращает HTTP 402 (insufficient_credits). Ошибки движка (503) не списывают credit.

Авторизация и API-ключи

Безопасный доступ через заголовок Authorization.

  1. Войдите в панель и откройте API tokens (/account/api).
  2. Создайте production-ключ (ev_live_) или sandbox (ev_test_) в панели — полный secret показывается только один раз.
  3. Отправляйте ключ как Authorization: Bearer ev_live_… — никогда в URL или клиентском коде.
Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/json

Быстрый старт — API верификации email

Два вызова: проверка баланса и первая верификация.

1. Проверить баланс кредитов

curl https://propercheck.pl/api/v1/credits \
  -H "Authorization: Bearer ev_live_YOUR_KEY"

2. Верифицировать один email-адрес

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

Одиночная верификация (real-time)

POST /api/v1/verify принимает JSON с полем email. Ответ содержит status, score 0–100, provider (Google, Microsoft, региональные хосты) и enrichment (MX, catch-all).

POST /api/v1/verify

Структура JSON-ответа

Поля после успешной верификации.

{
  "verificationId": "ver_abc123",
  "email": "john@company.com",
  "status": "valid",
  "score": 92,
  "provider": "google",
  "enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
  "creditsRemaining": 149
}

Статусы верификации email

Классификация в API, панели и CSV-экспорте.

valid

valid — адрес существует и принимает почту; безопасно для отправки.

invalid

invalid — адрес не существует или домен без почты; удалите из списка.

risky

risky — низкая уверенность (например disposable, role account); осторожно в кампаниях.

catch_all

catch_all — сервер принимает все адреса домена; выше риск bounce.

unknown

unknown — неоднозначный SMTP-ответ; рассмотрите повторную верификацию.

Справочник REST-эндпоинтов

Полный список путей API v1 со стоимостью в кредитах.

МетодПутьКредитыОписание
POST/verify1Одиночная верификация email в реальном времени
GET/verify/:id0Получить результат по verificationId
GET/verifications0История верификаций и статистика за 30 дней
GET/credits0Текущий баланс кредитов аккаунта
POST/bulkNСоздать bulk job (N кредитов)
GET/bulk/:id0Статус и прогресс bulk job
GET/bulk/:id/export0Скачать результаты как CSV
GET/POST/PATCH/DELETE/api-keys0Управление API-токенами (сессия)
GET/POST/DELETE/webhooks0Настройка webhooks (сессия)
GET/usage0Статистика использования API и кредитов

API массовой верификации email

Проверка тысяч адресов в одном job — идеально перед крупной кампанией.

  1. POST /bulk с массивом emails или CSV-текстом — кредиты за N уникальных адресов.
  2. GET /bulk/:id — polling статуса (queued → processing → completed).
  3. GET /bulk/:id/export — CSV с колонками email, status, score, provider.
curl -X POST https://propercheck.pl/api/v1/bulk \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@b.co","c@d.co"]}'

Вебхуки — verification.completed

Получите POST на ваш URL после завершения верификации. Заголовок X-EV-Signature содержит HMAC-SHA256 body — проверьте подпись перед обработкой.

X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>

Лимиты запросов

По умолчанию 60 запросов в минуту на API-ключ. Превышение возвращает HTTP 429 с rate_limit_exceeded. Лимиты per key — отдельные токены для интеграций.

Опциональный заголовок для POST /verify — безопасный retry без двойного списания credit (TTL 24ч).

X-Request-Id

Каждый ответ API содержит X-Request-Id — укажите его при обращении в поддержку для отладки интеграции.

HTTP-коды ошибок

HTTPКодОписание
401unauthorizedНет сессии или API-ключа в запросе.
401invalid_api_keyНедействительный, просроченный или отозванный API-ключ.
400invalid_requestНеверный JSON, отсутствует поле email или некорректный адрес.
402insufficient_creditsНедостаточно кредитов — пополните на /account/credits.
429rate_limit_exceededПревышен лимит — по умолчанию 60 запросов/мин на API-ключ.
503engine_unavailableДвижок верификации недоступен — credit не списывается.

Примеры интеграции

Тот же flow верификации на популярных языках.

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

FAQ — API верификации email

Частые вопросы разработчиков и маркетологов.

OpenAPI 3.1 и Redoc

Машиночитаемая спецификация для codegen, контрактных тестов и CI.

Скачать openapi-v1.yamlИнтерактивный справочник Redoc

Начните верифицировать email через API

Бесплатные пробные кредиты при регистрации. API-ключ в панели за минуту.

Создать аккаунтТокены API

Сгенерируйте ключ в панели аккаунта.