🎬 Представляем transcript.im: бесплатные расшифровки видео с YouTube, TikTok и Instagram.Открыть transcript.im

API валидации Email

Один endpoint для всех типов верификации. API валидации email в реальном времени с проверками SMTP, структурированными JSON-ответами и нативной интеграцией с MCP и Agent Skills.

Email Validation API: эндпоинт BillionVerify с примерами запроса и ответа
API валидации Email

Проверяйте в реальном времени

Используйте простой API-вызов для проверки адресов при регистрации, обогащении, рабочих процессах ИИ-агентов или пользовательских конвейерах обработки списков.

Структурированный JSONОтвет в реальном времениSMTP-верификация
Get Started for Free
API валидации email в реальном времени: BillionVerify отвечает за миллисекунды

Все режимы API валидации, один endpoint

Все типы верификации доступны через один REST API валидации email.

Режимы API валидации BillionVerify: одиночная проверка, пакетная и потоковая

Верификация одного email

POST /verify — один вызов API валидации email в реальном времени с ответом менее чем за 3 секунды. Возвращает статус, доставляемость, оценку качества и флаги риска в одном JSON-объекте.

Пакетная верификация

POST /verify/bulk — синхронная валидация до 50 адресов за один API-вызов. Все результаты возвращаются в одном API-ответе по той же схеме, что и при валидации одного адреса.

Асинхронная обработка файлов

POST /verify/file — отправка файлов CSV или Excel в API для фоновой обработки. Результаты передаются через webhook callback после завершения задания API.

Официальные SDK

Типобезопасные клиентские библиотеки для бесплатного API валидации email на Python, Node.js, Go и PHP. Автоматические повторы при сбоях, полная обработка ошибок и одинаковые типы ответов для всех языков.

Поддержка webhook в API валидации

Получайте результаты API асинхронно и запрашивайте историю сообщений.

Webhook в API валидации BillionVerify: асинхронные уведомления о готовности проверки

Асинхронная доставка

Создание webhook

Зарегистрируйте HTTP endpoints, чтобы получать результаты API сразу после завершения задания или пакета. API поддерживает пользовательские payload, автоматические повторы при сбоях и настройку для отдельных заданий или всего аккаунта.

  • События завершения задания с итоговой сводкой
  • Автоматический повтор при неудачной доставке
  • Конфигурация на уровне задания или аккаунта

История сообщений

Запрос сообщений

Используйте полный журнал webhook-событий, чтобы получать прошлые результаты API, отлаживать сбои доставки или повторно отправлять пропущенные уведомления. События API хранятся 30 дней.

  • Запрос событий по ID задания или диапазону дат
  • Повтор пропущенных или неудачных доставок
  • Хранение событий 30 дней

Контракт ответа

Что возвращает API валидации email: разбор по полям

Большинство команд внедряют API валидации вместо регулярного выражения. Переход оправдан, только если ответ API содержит больше информации, чем заменяемое им логическое значение.

Поле status, по которому код должен выбирать ветвь

API возвращает один из четырёх статусов: доставляемый, недоставляемый, рискованный или неизвестный. Статусов четыре, потому что реальность не сводится к двум состояниям; API валидации, который оставляет только true и false, вынуждает каждого клиента заново восполнять утраченные нюансы.

Сначала выбирайте ветвь по status. Всё остальное в ответе бесплатного API валидации email объясняет этот статус, а не заменяет его.

score и уровень риска нужны для ранжирования, а не блокировки

Оценка качества от 0 до 100 и уровень риска позволяют сортировать очередь, выбирать приоритет последующих контактов отдела продаж или настраивать порог для каждого сценария. Это производные поля API, поэтому считайте их подсказками для упорядочивания, а не вердиктом API.

Блокировка только по score приводит к случайному отказу хорошим клиентам. Блокируйте по status, ранжируйте по score.

Коды причин упрощают отладку API

Каждый ответ API с недоставляемым адресом содержит машиночитаемую причину. Ошибка синтаксиса, отсутствие почтового маршрута, отклонение ящиком и отсрочка провайдера представляют собой разные проблемы с разными решениями, и наш бесплатный API валидации email называет каждую из них вместо общей ошибки.

Записывайте в журнал код причины API, а не текст. Он стабилен между релизами и позволяет разобраться с обращением поддержки по конкретному адресу даже спустя месяцы.

Логические флаги описывают адрес, а не его доставляемость

Одноразовый адрес, ролевой аккаунт, catch-all и бесплатная личная почта передаются как независимые флаги API. Адрес может быть полностью доставляемым и одновременно иметь три таких флага, что как раз нельзя выразить валидатором синтаксиса, но можно через API.

В этом практическая разница между API валидации email в реальном времени и проверкой формата: проверка формата показывает, что строка имеет правильную форму, а API показывает, чем адрес является на самом деле.

Миграция

Переход от валидатора синтаксиса к настоящему API валидации

Обычно у команд уже есть regex или вызов библиотеки в кодовой базе. Миграция на API невелика, но вместе с ней нужно изменить три привычки.

Не считайте формат окончательным ответом

Регулярное выражение доказывает, что строка может быть адресом. Этот бесплатный API валидации email доказывает, что почтовый сервер принимает его сейчас. Можете оставить regex как дешёвую подсказку на стороне клиента, но не позволяйте ему решать, пригодна ли запись.

На практике нужно удалить ветвь, которая сохраняет запись при верном формате, и заменить её ветвлением по полю status ответа API.

Задайте для API timeout и запасной сценарий

Сетевой вызов может замедлиться, если медленно отвечает принимающий провайдер. Задайте для API приемлемый для формы timeout и заранее решите, что делать по его истечении: обычно принять адрес, пометить его как непроверенный и позже повторить API-вызов.

API валидации email в реальном времени никогда не должен становиться причиной сбоя регистрации. Снижайте статус до непроверенного, а не до отклонённого.

Храните результат как данные, а не как фильтр

Записывайте в запись статус API, код причины, флаги и метку времени проверки. Команда, которая хранит только очищенное логическое значение, не сможет объяснить решение о подавлении через три кампании и отличить свежие данные API от устаревших.

Хранение полного ответа API также позволяет менять правила без повторной верификации: факты остаются, меняется только читающее их правило.

Обрабатывайте unknown осознанно и единообразно

Unknown не является ошибкой API или сбоем. Это означает, что принимающий провайдер не дал окончательного ответа. Определите политику повторов в одном месте — очередь, задержку и максимальное число попыток API — вместо разрозненных ситуативных повторов по всей кодовой базе.

Большинство результатов unknown уточняются при последующем API-вызове, поэтому наш бесплатный API валидации email сообщает их честно, а не пытается угадать.

Способы интеграции

Четыре способа вызвать API валидации email

Один endpoint, четыре варианта API. Выбирайте по объёму и допустимой задержке работы, а не по личным предпочтениям.

  1. 1

    Один адрес, синхронно

    POST /verify принимает один адрес и возвращает полный JSON за время от одной до трёх секунд. Этот путь API валидации email в реальном времени используется в формах регистрации, checkout и редактировании профиля.

    Поскольку это один API-вызов без жизненного цикла задания, его проще всего протестировать перед созданием более крупной интеграции.

  2. 2

    До 50 адресов за один вызов

    POST /verify/bulk синхронно проверяет до 50 адресов и возвращает их по одной схеме. Используйте его, когда страница или задание естественным образом обрабатывает несколько записей за раз.

    Лимит пакета является жёсткой границей API, а не рекомендацией. Большие payload отклоняются с понятной ошибкой API, которая указывает на файловый endpoint, поэтому запрос не становится незаметно медленным.

  3. 3

    Файлы, асинхронно

    POST /verify/file принимает CSV или Excel, обрабатывает файл в фоне и вызывает ваш webhook после завершения задания API. При обработке большого файла не нужно держать соединение открытым.

    Для работы со списками вместо отдельных API-вызовов используйте Массовую проверку email с тем же механизмом обработки загруженного файла, дедупликацией и экспортом CSV.

  4. 4

    Из ИИ-агентов и MCP-клиентов

    MCP Server предоставляет тот же API валидации email в Claude Desktop и Cursor на естественном языке, а Agent Skills устанавливают его на агентские платформы в один клик. Оба варианта возвращают тот же структурированный JSON, что и REST API.

    Так поведение агента остаётся честным: инструмент не может представить unknown как нормальный результат, потому что агент читает сам ответ бесплатного API валидации email.

Область применения

Что API валидации намеренно оставляет вам

API намеренно решает узкую задачу. Каждый пункт ниже — реальное требование, но выполнять его следует в другой части вашей системы, а не в API валидации.

Согласие и подавление

Наш бесплатный API валидации email определяет, принимает ли адрес почту. Он не знает, согласился ли человек получать ваши сообщения, и не читает ваш список подавления.

Храните согласие в собственной системе учёта и проверяйте его до API-вызова, а не после.

Личность и место работы

Доставляемый корпоративный адрес не доказывает, что указанный человек управляет им или всё ещё работает в компании. Псевдонимы, общие ящики и устаревшие обогащённые данные регулярно опровергают это предположение.

Используйте собственные данные для установления личности. Этот бесплатный API валидации email предоставляет сведения о почтовом ящике, а не о человеке.

Попадание во входящие

Принятие по SMTP является фактом на стороне получателя. Попадание сообщения во входящие зависит от репутации отправителя, аутентификации, содержимого и истории жалоб, которые API не может наблюдать.

Улучшайте качество адресов через API; попадание во входящие улучшайте работой на стороне отправителя и мониторингом, который API не может выполнить за вас.

Актуальность

Каждый ответ API описывает момент вызова. Ящики закрываются, псевдонимы отключаются, а домены мигрируют, поэтому сохранённый результат API устаревает независимо от того, перечитывает ли его кто-нибудь.

Повторяйте верификацию по расписанию, соответствующему скорости изменения данных, и автоматически принимайте решение по метке времени последней проверки.

Связанные инструменты

Место API валидации email среди других инструментов

Один механизм лежит в основе нескольких интерфейсов API. Выбор зависит от того, кто делает запрос и сколько адресов нужно обработать.

Верификация через тот же endpoint

API проверки email описывает тот же endpoint для команд, которые ищут верификацию, а не валидацию, и подробнее объясняет доказательства SMTP.

Схема, кредиты и точность идентичны — различается только подача документации.

Браузерный инструмент для одного адреса

Когда нужно просмотреть один результат, а не автоматизировать процесс, Верификатор email запускает тот же процесс в браузере и показывает все флаги, которые вернул бы API.

Это самый быстрый способ проверить работу механизма до написания кода для бесплатного API валидации email.

Поверхностная валидация без SMTP

Если нужны только формат и маршрутизация почты, Валидатор email ограничивается синтаксисом и MX и не расходует SMTP-проверку.

Используйте его для дешёвой предварительной фильтрации и оставьте API валидации email в реальном времени для записей, где недоставка действительно приведёт к расходам.

Часто задаваемые вопросы

1. Насколько быстр API валидации email?

Кэшированные результаты API возвращаются менее чем за 200ms. Полная SMTP-валидация занимает в среднем 1–3 секунды, поэтому API подходит для проверки email в форме в реальном времени. API поддерживает до 6,000 одиночных и 1,500 пакетных запросов в минуту.

2. Как интегрировать API валидации email?

API валидации использует стандартные REST-вызовы с JSON-ответами. Официальные SDK доступны для Python, Node.js, Go и PHP. Большинство интеграций API занимает менее 30 минут. MCP Server и Agent Skills вообще не требуют кода — установите их один раз, и бесплатный API валидации email будет работать в любом поддерживаемом ИИ-клиенте.

3. Сколько стоит API валидации email?

Тариф Starter стоит $20 за 20,000 кредитов по $0.001 за email — без ежемесячной платы, вы платите только за использование. При больших объёмах цена снижается до $0.00035 за email за 1M кредитов. Бесплатный тариф API валидации email предоставляет 20 кредитов за каждый день входа, до 600 в месяц, без кредитной карты.

4. Что включает каждый ответ API валидации?

Каждый ответ API включает статус валидации (доставляемый, недоставляемый, рискованный или неизвестный), оценку качества 0–100, уровень риска и коды причин. Также включены флаг одноразового email, флаг ролевого аккаунта, определение catch-all и предложения по исправлению опечаток.

5. Безопасен ли API валидации?

Все запросы API используют HTTPS. Каждый API-вызов требует аутентификации по API-ключу; для дополнительной безопасности доступен белый список IP. BillionVerify полностью соответствует GDPR и CCPA и автоматически удаляет данные после обработки.

6. Как ИИ-агенты и LLM используют этот API валидации?

ИИ-агенты подключаются через MCP Server (естественный язык в Claude и Cursor), готовые Agent Skills (установка в один клик для Claude и Manus) или прямые REST-вызовы из LangChain, CrewAI либо любого SDK Anthropic или OpenAI. Все варианты обращаются к одному API валидации email и возвращают одинаковый структурированный JSON — преобразовывать ответ не нужно.

7. В чём разница между API валидации email и API верификации email?

API валидации email и API проверки email обычно означают одно и то же — endpoint, который определяет, существует ли адрес и можно ли доставить на него письмо. BillionVerify выполняет проверки на уровне SMTP, подтверждая наличие ящика на принимающем сервере, а не ограничивается DNS или синтаксисом. Единый endpoint /verify возвращает статус, оценку качества, флаги одноразового и ролевого адреса, а также определение catch-all в одном JSON-ответе.

API валидации Email

Получите API-ключ

Один endpoint для всех типов валидации. MCP Server и Agent Skills включены. Бесплатный тариф API валидации email даёт 20 кредитов за каждый день входа, до 600 в месяц, без кредитной карты.

600 бесплатных кредитов в месяц · Нативная интеграция MCP Server · Без кредитной карты

99.9%
Точность
Real-time
Скорость API
$0.00014
За e-mail
600/mo
Бесплатно навсегда