Проверка email в реальном времени

POST/v1/realtime/check/email

Синхронно проверяет один адрес электронной почты по одному — десяти продуктам реального времени для email. Движок, контракт биллинга и форма ответа идентичны телефонному эндпоинту; отличаются только серия и формат идентификатора.

Параметры

Поле	Тип	Обязательно	Описание
`identifier`	string	Да	Один адрес электронной почты, например `user@example.com`.
`country`	string	Нет	Для email должен быть опущен. Передача кода страны с email-продуктом отклоняется.
`product_ids`	array<int>	Да	Массив из 1 до 10 ID продуктов реального времени для email.

Выбор продуктов

Email- и телефонные продукты — это разные серии, и их нельзя объединять в одном запросе. Считайте id записи, у которой mode равен realtime и серия — email, из Продукты реального времени, который основан на GET /v1/products. Передача slug здесь никогда не работает, а ID телефонного продукта в email-вызове отклоняется как несовместимая серия.

Пример ответа

{
  "request_id": "b7d2a1c4-9f3e-4a1b-8c5d-2e6f7a8b9c0d",
  "identifier": "user@example.com",
  "series": "email",
  "status": "succeeded",
  "request_status": "completed",
  "replayed": false,
  "total_reserved": 0.004000,
  "total_charged": 0.004000,
  "total_refunded": 0.000000,
  "results": [
    {
      "product_id": 49,
      "product": "insemailvalid-rt",
      "result": "valid",
      "cached": false,
      "billing_status": "charged",
      "charged_amount": 0.002000,
      "refunded_amount": 0.000000,
      "checked_at": "2026-09-13T10:00:00Z",
      "error_code": null
    }
  ]
}

Значения product_id выше — примеры; подтвердите текущие ID email-продуктов на странице Продукты реального времени до отправки реального запроса. request_id — это UUID, а cached находится внутри каждого результата, а не на верхнем уровне.

Пример cURL

curl -X POST "https://api.zelnum.com/api/v1/realtime/check/email" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"user@example.com","product_ids":[49]}'

Ошибки, специфичные для email

HTTP	`code`	Значение
400	`invalid_realtime_request`	Адрес имеет неверный формат, был передан `country`, ID относятся к другой серии или ни один ID не указан. Ничего не отправляется и ничего не списывается.
400	`idempotency_key_required`	Заголовок `Idempotency-Key` отсутствует.
402	`insufficient_balance`	Баланса не хватает на резерв; ни один элемент не запускается.
409	`request_in_progress` / `idempotency_conflict`	Тот же ключ, всё ещё выполняется, или тот же ключ с другой полезной нагрузкой.

Остальные коды статуса — 401, 403, 429, 503, 500 — ведут себя точно так, как описано в телефонном эндпоинте.