Валидация Email

Проверить один email-адрес

Отправляет один email-адрес на валидацию. Система проверяет существование почтового ящика через DNS/MX-записи, SMTP-подключение и провайдер-специфичные методы.

Как это работает:

  1. Email проходит синтаксическую проверку. Если формат невалидный — возвращается мгновенный ответ с status: "invalid" без списания кредитов.
  2. Если формат корректный — email ставится в очередь на проверку, списывается 1 кредит, возвращается task_id.
  3. Проверка занимает от нескольких секунд до 2 минут в зависимости от домена.

Получение результата:

  • Polling: используйте GET /api/v1/tasks/:taskId для отслеживания статуса, затем GET /api/v1/tasks/:taskId/results для получения результата.
  • Webhook: передайте webhook_url в запросе — мы отправим POST-запрос на указанный URL, когда проверка завершится.

Кредиты: 1 email = 1 кредит. Кредит списывается сразу при постановке в очередь. Невалидные по синтаксису email не тарифицируются.

post/api/v1/validate/single

Request

  • Base URL: https://api.uchecker.net
  • URL: https://api.uchecker.net/api/v1/validate/single
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

emailstring required

Email-адрес для проверки. Должен соответствовать стандартному формату RFC 5322 (например, user@domain.com).

client_type'web' | 'api' | 'mcp' | 'sheets' | 'extension'

Кто отправил запрос. Значение сохраняется в задаче и видно в статистике. Наши клиенты называют себя сами: web — личный кабинет, mcp — MCP-сервер, sheets — дополнение для Google Таблиц, extension — расширение Chrome. Если поле не передано, задача помечается как api.

webhook_urlstring

URL для webhook-уведомления о завершении проверки. Формат тела запроса совпадает с webhook массовой проверки — см. POST /api/v1/validate/bulk.

Example request

{
  "email": "user@example.com",
  "client_type": "api",
  "webhook_url": "https://your-site.com/webhook/validation-complete"
}

Response

Email поставлен в очередь на валидацию. Используйте task_id из ответа для получения результата.

successboolean required

Признак успешного выполнения запроса

task_idnumber required

Уникальный идентификатор задачи. Используйте для получения результатов через GET /api/v1/tasks/:taskId.

emailstring required

Email-адрес, отправленный на проверку

statusstring required

Текущий статус email. Значение queued означает, что адрес принят в обработку.

credits_usednumber required

Количество кредитов, списанных за этот запрос

credits_remainingnumber required

Остаток кредитов на балансе после списания

estimated_completionstring required

Ориентировочное время завершения проверки. Формат ISO 8601.

Example response

{
  "success": true,
  "task_id": 123,
  "email": "user@example.com",
  "status": "queued",
  "credits_used": 1,
  "credits_remaining": 999,
  "estimated_completion": "2024-01-01T12:00:30.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.