API пакетной проверки MailValidator.Ru

автоматизация проверки mailvalidator.ru

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

API пакетной проверки — максимально эффективный способ проверки существования имейлов списками (пакетами), которые включают в себя адреса электронной почты в любых доменных зонах.

Проверка осуществляется путем загрузки пакета (batch) и запросом ответа, после завершения проверки.

Отправить батч на проверку

emails- обязательное поле. Минимальный размер 10000 адресов
comment– необязтелньое поле. Как возможный вариант заполнения – имя файла


#python

r = requests.post("http://mailvalidator.ru:30083/batch", json=payload)

#где payload:

payload = {"emails":["test@mail.ru", "ada@ya.ru"], "comment":"customer_emails1.txt"}

#curl

curl --header "Content-Type: application/json" -XPOST http://mailvalidator.ru:30083/batch -d '{"emails":["test@mail.ru","ada@ya.ru"], "comment":"customer_emails1.txt"}'

Если запрос удачный — код ответа 200 и UUIDсписка.
Пример:


{"UUID":"fc3d9993"}

Если запрос возвращает ошибку — ответ будет содержать текст Error и описание.

Пример:


{"Error":"batch size to small. Minimum 10000 emails"}

Получить результаты проверки батча


#python

r = requests.get("http://mailvalidator.ru:30083/batch?uuid=59cb3daf")

#curl

curl --header "Content-Type: application/json" -XGET http://mailvalidator.ru:30083/batch?uuid=59cb3daf

Если тело ответа содержит Fullcheck processing, необходимо дождаться завершения проверки


{"Status":"Fullcheck processing"}

Скорость проверки

Скорость проверки полностью зависит от состава доменных зон в вашем списке. Обычно батч размером 10000 адресов проверяется от нескольких минут до 1 часа, однако в исключительных случаях время проверки может быть до 3 часов и более

Успешный запрос будет содержать ответ следующего формата:


{'batchStat': {'duplicateCount': 3,
  'emailsSet': 15,
  'lines': 21,
  'notEmailsSet': 3},
 'checkStat': {'B': 7, 'N': 3, 'OK': 8},
 'duplicates': {'akalachov@mail.ru': 2, 'xpert@yandex.ru': 1},
 'emails': {'akalachoff@yandex.ru': 'fOK',
  'akalachov@mail.ru': 'fOK',
  'andadasdaqcasdf4erfrew@yahoo.com': 'fB',
  'andrew2edasd32r@aol.com': 'fOK',
  'andrew@aol.com': 'fOK',
  'buntik87@mail.ru': 'fOK',
  'danbv0re0@rambler.ru': 'fB',
  'djackson@yahoo.com': 'fOK',
  'dsadvsfndg@bk.ru': 'fB',
  'fadsqwxwqdwq11@gmail.com': 'fB',
  'fvbnosdfbnpddg': 'N',
  'fvbnosdfbnpdg': 'N',
  'fvbnosdfbnpdsdasg': 'N',
  'kalachovalex@gmail.com': 'fOK',
  'malash18@mail.ru': 'fB',
  'nvospfdn@aol.com': 'fOK',
  'vnsdfov@test.com': 'fB',
  'xpert@yandex.ru': 'fB'},
 'ip': '1.1.1.1',
 'timestamp': 1625255303,
 'total': 21,
'comment': продажи.txt,
 'uuid': 'some_test_uuid'}

Тестовый endpoint

Для удобства тестирования и интеграции есть тестовый эндпойнт, который нужен для проверки корректности составления запросов. Реальная отправка имейлов в проверку происходить не будет.

Отправка тестового батча:


#python

r = requests.post("http://mailvalidator.ru:30083/test_batch", json=payload)

#curl

curl --header "Content-Type: application/json" -XPOST http://mailvalidator.ru:30083/test_batch -d '{"emails":["test@mail.ru","ada@ya.ru"], "comment":"customer_emails1.txt"}'

Получение тестовых результатов:


#python

r = requests.get("http://mailvalidator.ru:30083/test_batch?uuid=86db9674")

#curl

curl --header "Content-Type: application/json" -XGET http://mailvalidator.ru:30083/test_batch?uuid=59cb3daf

Важное сообщение про квотирование!
АПИ разрешает 1 запрос в течение 30 минут. Под запросом понимается как успешный, так и неуспешный запрос.
Для настройки интеграции, во избежании ожидания разрешения для следующих запросов, необходимо использовать тестовый эндпойнт.

Пример возвращаемых статусов:

eA — активные имейлы, адреса с которых были зафиксированы открытия и переходы (на базе информации Сервисов рассылок являющихся партнерами Сервиса)
eBad — стоп-лист на базе экспресс-проверки (проверяет все имейлы с известной сервису почтовой историей)
fB — несуществующй ящик
fOK — существующй ящик
fS — заброшенные/переполненные/неиспользуемые пользователями ящики
fT — Temporary-ящик (адреса в доменах временной почты)
N — не имейл (начертание имейла не соответсвует RFC)

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

Минимальный батч, отправляемый в проверку, должен содержать 10000 адресов.

Для подключения к API требуется заключение договора.

Ознакомиться с формой типового договора можно здесь

Свяжитесь с нами по адресу электронной почты request@mailvalidator.ru или по телефону 8-800-505-45-61