Что такое API для проверки электронной почты?

API для проверки электронной почты позволяет вам валидировать email-адреса в реальном времени через GET-запрос. Он проверяет синтаксис, MX-записи, черные списки и выполняет SMTP-верификацию.

Как я могу аутентифицироваться, используя API?

Вы должны предоставить действительный API-ключ, сгенерированный из вашей панели управления EmailVerify.io. Запросы без ключа или с недействительным ключом завершатся неудачей.

Какие проверки выполняются во время валидации электронной почты?

Проверки включают валидацию регулярного выражения, поиск MX-записей, проверку черного списка MX и верификацию почтового ящика на уровне SMTP.

Какие сообщения об ошибках может вернуть API?

Распространенные ошибки включают Invalid API Key, Invalid Request, 0 credits remaining и Please try again, когда сервер сталкивается с проблемой.

Могу ли я проверить свои оставшиеся кредиты через API?

Да. Конечная точка /check-account-balance/ позволяет вам проверить статус API, дневные лимиты, реферальные кредиты и оставшиеся кредиты.

Документация по API проверки электронной почты

Инструкции мгновенной проверки

Введение

Добро пожаловать в API проверки одного email EmailVerify.io! Этот API позволяет проверять отдельный адрес email в реальном времени с помощью простого запроса, обеспечивая точность и надежность вашей электронной почты.

Аутентификация

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

Конечная точка API

Проверяйте отдельный email, заменив плейсхолдеры на ваш уникальный API ключ и адрес email в следующем URL:

Получить URL запроса (HTTPS)

https://app.emailverify.io/api/v1/[email protected]

Пример успешного ответа

Вы получите ответ, как показано ниже, если запрос одного email успешно обработан:

URL

{
  "email": "[email protected]",
  "status": "valid",
  "sub_status": "permitted"
}

Проверки при проверке одного email

Проверка Regex: Проверяйте структуру email с помощью стандартных шаблонов regex, чтобы выявить ошибки и опечатки до дальнейшей обработки.

Проверка MX: Проверяйте действительные записи Mail Exchange (MX), чтобы подтвердить, что домен email настроен для получения сообщений и активен.

Проверка MX на черные списки: Определяйте домены в известных черных списках спама или вредоносной активности, чтобы избежать ненадежных или опасных адресов.

Проверка SMTP: Проверка в реальном времени путем пинга SMTP сервера получателя, чтобы убедиться, что email существует и может получать сообщения.

Ответы с ошибками

Сообщение об ошибке

Описание

Недействительный API ключ

Если ключ отключен или не существует

Неверный запрос

недействительные параметры в конечной точке API

Осталось 0 кредитов

У пользователя нет кредитов

Пожалуйста, попробуйте снова

Если что-то пошло не так на нашей стороне

Проверить баланс аккаунта

Используйте следующий GET-запрос, чтобы проверить текущий баланс аккаунта (оставшиеся ежедневные и мгновенные кредиты).

URL GET-запроса (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Здесь замените <Your_API_Key> на ваш действующий API ключ.

Ответ (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Инструкции по массовой проверке

Введение

Добро пожаловать в API массовой проверки email EmailVerify.io! Этот API позволяет проверять до 5000 адресов электронной почты в реальном времени с помощью простого запроса, обеспечивая точность и надежность вашей email коммуникации.

Этот эндпоинт позволяет отправлять нам пакеты до 5000 адресов за раз. Если вы хотите проверять отдельные email, используйте наш эндпоинт для проверки одного email.

Аутентификация

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

API эндпоинт

Проверка одного адреса электронной почты путем замены заполнителей вашим уникальным API ключом и адресом email для проверки в следующем URL

URL POST-запроса (HTTPS)

https://app.emailverify.io/api/v1/validate-batch

POST-запрос

Вы можете проверить до 5000 адресов электронной почты, отправив их в следующем POST-запросе.

POST-запрос

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "[email protected]" },
    { "address": "[email protected]" },
    { "address": "[email protected]" }
  ]
}

Пример успешного ответа

Вы получите ответ такого вида, когда задача массовой проверки успешно создана.

URL

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

GET-запрос

Этот эндпоинт возвращает результаты ранее созданной задачи массовой проверки email. Результаты включают общий статус задачи и, если задача завершена, результаты проверки email.

URL GET-запроса

https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

Пример успешного ответа

Пример ответа после завершения вашей задачи проверки:

POST-запрос

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "[email protected]",
        "status": "invalid",
        "sub_status": "No dns entries"
      }
    ]
  }
}

Проверки, выполняемые при массовой проверке email

Проверка с помощью Regex: Проверяет структуру адресов электронной почты по стандартным шаблонам regex, чтобы выявить опечатки и ошибки форматирования до дальнейшей обработки.

Проверка MX: Проверяет наличие действительных записей Mail Exchange (MX), чтобы убедиться, что домен email настроен для приема сообщений и существует.

Проверка MX в черных списках: Определяет домены, внесенные в известные черные списки для спама или вредоносной активности, помогая избегать ненадежных или опасных адресатов.

Проверка SMTP: Проводит проверку в реальном времени, отправляя ping на SMTP-сервер получателя, чтобы подтвердить, что адрес email активен и может получать письма.

Ответы об ошибках

Сообщение об ошибке

Описание

Недействительный API ключ

Если API ключ отключен или не существует.

Недействительный запрос

Если запрос содержит недопустимые параметры.

0 доступных кредитов

Если у пользователя нет доступных кредитов.

Попробуйте снова

Когда на нашей стороне происходит ошибка.

Проверить баланс аккаунта

Используйте следующий GET-запрос, чтобы проверить текущий баланс аккаунта (оставшиеся дневные и мгновенные кредиты).

URL GET-запроса (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Здесь замените <Your_API_Key> на ваш активный API ключ.

Ответ (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Инструкции по поиску отдельного email

Введение

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

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

Аутентификация

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

API эндпоинт

URL

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

Пример ответа, если email найден

Вы получите аналогичный ответ, если email найден

Ответ, если найден

{
  "email": "[email protected]",
  "status": "found"
}

Пример ответа, если email не найден

Вы получите аналогичный ответ, если email не найден

Ответ, если не найден

{
  "email": "null",
  "status": "not_found"
}

Проверки, выполняемые в Email Finder

Проверка комбинаций: Проверяет предоставленное имя по двадцати пяти комбинациям с доменным именем и определяет, какая из них дает действительный адрес email.

Ответы об ошибках

Сообщение об ошибке

Описание

Недействительный API ключ

Если ключ отключен или не существует

Недействительный запрос

Недопустимые параметры в API эндпоинте

0 доступных кредитов

У пользователя нет кредитов

Бесплатные домены заблокированы

Когда пользователь пытается найти email на бесплатном домене

Проверить баланс аккаунта

URL GET-запроса (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance?key=<Your_API_Key>

Здесь замените <Your_API_Key> на ваш активный API ключ.

Ответ (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100
  "remaining_credits": 15000
}