8-800-505-45-61
Email: request@mailvalidator.ru
Справочный центр по использованию АПИ MAILVALIDATOR.RU
и встроенных сервисов на основе АПИ
и встроенных сервисов на основе АПИ
АПИ MAILVALIDATOR.RU
Ответы на часто задаваемые вопросы по использованию API
Сервис АПИ и основной Сервис MAILVALIDATOR.RU — это физически и юридически разные Сервисы.
Сервисы используют разные балансы и личные счета. Каждый Сервис имеет собственный биллинг и/или счета для отплаты услуг юридическими лицами.
Баланс счета MAILVALIDATOR.RU нельзя использовать для оплаты услуг Сервиса АПИ, равно как баланс счета АПИ нельзя использовать для осуществления проверок списков в сервисе MAILVALIDATOR
Учитывайте это, если вы используете в своей работе оба Сервиса проверок ваших адресов
Сервисы используют разные балансы и личные счета. Каждый Сервис имеет собственный биллинг и/или счета для отплаты услуг юридическими лицами.
Баланс счета MAILVALIDATOR.RU нельзя использовать для оплаты услуг Сервиса АПИ, равно как баланс счета АПИ нельзя использовать для осуществления проверок списков в сервисе MAILVALIDATOR
Учитывайте это, если вы используете в своей работе оба Сервиса проверок ваших адресов
API единичной проверки — максимально эффективный способ проверки существования имейла «налету».
API необходимо когда, например, посетители вашего сайта оставляют вам адрес электронной почты в поле подписки, регистрации или другой форме и вы хотите "на входе" получить в базу валидный имейл или оповестить посетителя, что он допустил ошибку при вводе.
API необходимо когда, например, посетители вашего сайта оставляют вам адрес электронной почты в поле подписки, регистрации или другой форме и вы хотите "на входе" получить в базу валидный имейл или оповестить посетителя, что он допустил ошибку при вводе.
Проверка осуществляется в два этапа: Экспресс-проверка (по существующей базе адресов Сервиса, имеющих проверенную почтовую историю: хорошую/плохую); Полная проверка «налету» для адресов в следующих доменных зонах:
GmailDomains = gmail.com", "googlemail.com"
MailRuDomains = "mail.ru", "bk.ru", "list.ru", "inbox.ru"
RamblerDomains = "rambler.ru"
YandexDomains = "yandex.ru", "ya.ru", "yandex.com", "narod.ru", "yandex.ua", "tut.by", "yandex.kz", "yandex.by"
YahooDomains* = "y7mail.com", "sky.com", "rogers.com", "verizon.net", "rocketmail.com", "frontiernet.net", "frontier.com", "yahoo.com"
MicrosoftDomains* = "msn.com", "live.com", "outlook.com", "hotmail.com"
* (в связи с санкциями, введенными в отношении России, проверка данных доменных зон осуществляется "как есть", без гарантии стабильно достоверного результата)
Все остальные адреса АПИ возвращает как неизвестные.
Несмотря на ограничение Сервис покрывает более 85% (в России) всех адресов, которые подписчики обычно используют для рассылок.
GmailDomains = gmail.com", "googlemail.com"
MailRuDomains = "mail.ru", "bk.ru", "list.ru", "inbox.ru"
RamblerDomains = "rambler.ru"
YandexDomains = "yandex.ru", "ya.ru", "yandex.com", "narod.ru", "yandex.ua", "tut.by", "yandex.kz", "yandex.by"
YahooDomains* = "y7mail.com", "sky.com", "rogers.com", "verizon.net", "rocketmail.com", "frontiernet.net", "frontier.com", "yahoo.com"
MicrosoftDomains* = "msn.com", "live.com", "outlook.com", "hotmail.com"
* (в связи с санкциями, введенными в отношении России, проверка данных доменных зон осуществляется "как есть", без гарантии стабильно достоверного результата)
Все остальные адреса АПИ возвращает как неизвестные.
Несмотря на ограничение Сервис покрывает более 85% (в России) всех адресов, которые подписчики обычно используют для рассылок.
Возвращаемые статусы:
eBad — стоп-лист на базе экспресс-проверки (проверяет все имейлы с известной сервису почтовой историей)
fB — несуществующй ящик
fOK — существующй ящик
fX — неизвестный (обычно это адреса в корпоративных доменах, которые не входят в список проверяемых адресов. Для данных адресов доступна дополнительная Полная проверка.)
fT — Temporary-ящик (адреса в доменах временной почты)
N — не имейл (начертание имейла не соответсвует RFC)
fail (fFail) — попытка проверки не удалась (например, почтовый сервер сбросил соединение)
eBad — стоп-лист на базе экспресс-проверки (проверяет все имейлы с известной сервису почтовой историей)
fB — несуществующй ящик
fOK — существующй ящик
fX — неизвестный (обычно это адреса в корпоративных доменах, которые не входят в список проверяемых адресов. Для данных адресов доступна дополнительная Полная проверка.)
fT — Temporary-ящик (адреса в доменах временной почты)
N — не имейл (начертание имейла не соответсвует RFC)
fail (fFail) — попытка проверки не удалась (например, почтовый сервер сбросил соединение)
Да, для этого существует метод пакетной проверки API, его описание находится на этой странице.
Это GET-запрос;
Доступ к API для разрешенных IP-адресов.
curl -XGET https://app.mailvalidator.ru/single?email=mail@yandex.ru
Доступ к API для разрешенных IP-адресов.
curl -XGET https://app.mailvalidator.ru/single?email=mail@yandex.ru
Подробнее с запросами пакетной проверки можно ознакомиться на этой странице.
Для подключения к API необходимо зарегистрироваться.
Если у вас есть действующая учетная запись в Сервисе MAILVALIDATOR.RU, вы можете перейти к использованию АПИ по этой ссылке.
Если у вас есть действующая учетная запись в Сервисе MAILVALIDATOR.RU, вы можете перейти к использованию АПИ по этой ссылке.
Сервис Форм
Ответы на часто задаваемые вопросы по использованию Сервиса Форм со встроенной валидацией имейл адресов
Сервис форм позволяет использовать основную функцию АПИ (проверка имейлов "налету") без программирования.
Сервис форм позволяет создать и разместить у себя на сайте форму с произвольными полями данных и встроенной валидацией вводимых имейл адресов.
Адреса, которые нельзя проверить "налету", можно отправить в дополнительную Полную проверку непосредственно из базы ваших адресов, которые хранятся в Сервисе.
Собирая данные пользователей, используя Сервис Форм, вы получаете максимально чистую и актуальную базу сразу в момент сбора.
Сервис форм позволяет создать и разместить у себя на сайте форму с произвольными полями данных и встроенной валидацией вводимых имейл адресов.
Адреса, которые нельзя проверить "налету", можно отправить в дополнительную Полную проверку непосредственно из базы ваших адресов, которые хранятся в Сервисе.
Собирая данные пользователей, используя Сервис Форм, вы получаете максимально чистую и актуальную базу сразу в момент сбора.
Статусы адресов хранятся в таблице "Данные" и могут быть следующих видов:
Основные статусы:
Ок — Валидный имейл
Bad — "Плохой" имейл
X — "Условно-валидный" имейл, требует дополнительно Полной проверки (о "Полной проверке" читайте во вкладке "Что такое адреса категории fX в единичной проверке" на данной странице ниже)
Дополнительные статусы:
T — Адрес временной почты
R — Ролевой адрес (admin@, support@ и т.д. — адреса, с которых невозможно получить достоверный Double Opt-In)
N/A — Непроверенный адрес. Данный статус появляется, если форма размещена на сайте, но не активна по причине недостаточного баланса. После пополнения баланса и заказа дополнительной Полной проверки, имейлы поменяют статус на Ok или Bad в зависимости от результата проверки.
Основные статусы:
Ок — Валидный имейл
Bad — "Плохой" имейл
X — "Условно-валидный" имейл, требует дополнительно Полной проверки (о "Полной проверке" читайте во вкладке "Что такое адреса категории fX в единичной проверке" на данной странице ниже)
Дополнительные статусы:
T — Адрес временной почты
R — Ролевой адрес (admin@, support@ и т.д. — адреса, с которых невозможно получить достоверный Double Opt-In)
N/A — Непроверенный адрес. Данный статус появляется, если форма размещена на сайте, но не активна по причине недостаточного баланса. После пополнения баланса и заказа дополнительной Полной проверки, имейлы поменяют статус на Ok или Bad в зависимости от результата проверки.
Для того, чтобы после создания формы встроить ее на станицу вашего сайта вам необходимо вставить <div> c кодом (генерируется для вашей формы) в нужное место внутри html-кода необходимой вам страницы.
Если для вашего сайта вы используете конструктор Tilda — вставьте на страницу блок Т123 и поместите внутрь него полученный код для встраивания
Сервис размещает логотип внизу встроенной формы. Логотип отключается на платной основе.
Внести единовременный платеж и отключить логотип можно в Конструкторе форм.
Внести единовременный платеж и отключить логотип можно в Конструкторе форм.
Сервис Форм, используя механизмы Единичной проверки АПИ проверяет все введенные в форму имейлы!
В таблицу "Данные с форм" попадают только валидные адреса и адреса категории fX, которые требуют дополнительной Полной проверки.
Невалидные и "отсеянные" адреса будут содержаться в общей таблице всех проверок, осуществленных через АПИ (вкладка "Данные")
В таблицу "Данные с форм" попадают только валидные адреса и адреса категории fX, которые требуют дополнительной Полной проверки.
Невалидные и "отсеянные" адреса будут содержаться в общей таблице всех проверок, осуществленных через АПИ (вкладка "Данные")
Общие вопросы
Ответы на часто задаваемые вопросы и общая информация организационного характера
Сервис Mailvalidator.Ru с 2014 года осуществляет проверку списков подписчиков на предмет существования имейлов и выявления в базах дополнительных "угроз" (спам-ловушки, "серийные жалобщики" и т.д.) для клиентов, осуществляющих рассылки по своим подписчикам.
АПИ базируется на постоянно развивающейся технологии Сервиса Mailvalidator.Ru и позволяет автоматизировать процесс проверок.
АПИ Сервиса Mailvalidator.Ru имеет механизмы проверки адресов как "налету", например во время заполнения подписчиком формы, так и в виде списков (батч), загружаемых через соответствующие методы АПИ.
Инструмент обеспечивает возможность попадания в вашу базу клиентов только существующих, проверенных адресов.
АПИ базируется на постоянно развивающейся технологии Сервиса Mailvalidator.Ru и позволяет автоматизировать процесс проверок.
АПИ Сервиса Mailvalidator.Ru имеет механизмы проверки адресов как "налету", например во время заполнения подписчиком формы, так и в виде списков (батч), загружаемых через соответствующие методы АПИ.
Инструмент обеспечивает возможность попадания в вашу базу клиентов только существующих, проверенных адресов.
Отплата услуг физическими лицами осуществляется через интернет-эквайринг Robokassa.
Подтверждение оплаты и ОФД-чеки Robokassa отправляет физическому лицу на почту, указанную при совершении операции оплаты. Акты оказанных услуг в данном случае не предоставляются.
Оплата услуг Юридическими лицами происходит автоматически после поступления денежных средств на наш расчетный счет. Счет Юридическое лицо выставляет самостоятельно в Личном кабинете пользователя.
Счет и закрывающие документы будут находиться в разделе "Финансы". Процедура получения оригиналов закрывающих документов описана в "Правилах ведения документооборота" в разделе "Финансы"
При возникновении любых проблем с оплатой, вы можете прислать обращение по электронной почте request@mailvalidator.ru с обязательным указанием номера счета и даты платежа. Для Юридических лиц также необходимо указать наименование и ИНН.
Подтверждение оплаты и ОФД-чеки Robokassa отправляет физическому лицу на почту, указанную при совершении операции оплаты. Акты оказанных услуг в данном случае не предоставляются.
Оплата услуг Юридическими лицами происходит автоматически после поступления денежных средств на наш расчетный счет. Счет Юридическое лицо выставляет самостоятельно в Личном кабинете пользователя.
Счет и закрывающие документы будут находиться в разделе "Финансы". Процедура получения оригиналов закрывающих документов описана в "Правилах ведения документооборота" в разделе "Финансы"
При возникновении любых проблем с оплатой, вы можете прислать обращение по электронной почте request@mailvalidator.ru с обязательным указанием номера счета и даты платежа. Для Юридических лиц также необходимо указать наименование и ИНН.
В Личном кабинете Сервиса в разделе "Финансы" есть электронные версии, там же опубликованы "Правила ведения документооборота" для получения оригиналов.
Документы (Акты оказанных услуг) направляются в систему ЭДО по окончании календарного месяца в срок до 10 числа следующего месяца. Если запрашиваются документы за периоды более 1 месяца назад, документы направляются в ближайшие рабочие дни.
Не забывайте подписывать документы в сервисе ЭДО
Документы (Акты оказанных услуг) направляются в систему ЭДО по окончании календарного месяца в срок до 10 числа следующего месяца. Если запрашиваются документы за периоды более 1 месяца назад, документы направляются в ближайшие рабочие дни.
Не забывайте подписывать документы в сервисе ЭДО
Контактный телефон 8-800-505-45-61 (с 8:00 до 16:00 по Московскому времени)
Общие и технические вопросы: request@mailvalidator.ru
Документы, бухгалтерия, ЭДО: doc@maildivision.biz
Общие и технические вопросы: request@mailvalidator.ru
Документы, бухгалтерия, ЭДО: doc@maildivision.biz
Любой запрос в АПИ сначала проходит через фильтры, которые существуют в сервисе MAILVALIDATOR.RU. Помимо списков несуществующих адресов в Сервисе существуют списки заведомо плохих / "токсичных" / "серийных" жалобщиков на спам, а так же адресов спам-ловушек. Из них некоторые адреса могут реально существовать, но Сервис категорически не рекомендует использовать их для рассылки.
Некоторые адреса, которые были помечены системой как «плохие» (получили статус eBad) существуют на самом деле.
Для этого есть ряд причин:
— Адрес находятся в категории «С» — то есть вероятность получения жалобы с такого адреса максимально высока и Сервис удалил адрес из списка (Адрес «токсичный»)
— Адрес может находиться к категории «Спам-ловушка»
— Адрес возвращает ошибки невозможности доставки (например, временно заблокирован почтовой системой или заморожен)
— Адрес возвращает ошибку «Ящик переполнен» (это ошибка почтовых сервисов, которая говорит о неактивности ящика и невозможности доставки рассылок в этот адрес, хотя личные сообщения до адресата доходят)
— Адрес находится в корпоративной почтовой сети, проверить которую невозможно по причинам настроек со стороны почтового администратора
— Адрес находится в нескольких стоп-листах Сервисов Рассылок
ВАЖНО: Сервис дает общую оценку качества имейла, основанную на нескольких десятках параметров. Ваша частная информация и история отправок может отличаться от общей картины Сервиса. «Токсичный» адрес для вашего списка (Рассылки) может быть самым активным клиентом, в то время как на все остальные рассылки, например, он нажимает кнопку «спам», поэтому был исключен из списка. Не отправляйте в проверку адреса, в которых вы уверены.
Некоторые адреса, которые были помечены системой как «плохие» (получили статус eBad) существуют на самом деле.
Для этого есть ряд причин:
— Адрес находятся в категории «С» — то есть вероятность получения жалобы с такого адреса максимально высока и Сервис удалил адрес из списка (Адрес «токсичный»)
— Адрес может находиться к категории «Спам-ловушка»
— Адрес возвращает ошибки невозможности доставки (например, временно заблокирован почтовой системой или заморожен)
— Адрес возвращает ошибку «Ящик переполнен» (это ошибка почтовых сервисов, которая говорит о неактивности ящика и невозможности доставки рассылок в этот адрес, хотя личные сообщения до адресата доходят)
— Адрес находится в корпоративной почтовой сети, проверить которую невозможно по причинам настроек со стороны почтового администратора
— Адрес находится в нескольких стоп-листах Сервисов Рассылок
ВАЖНО: Сервис дает общую оценку качества имейла, основанную на нескольких десятках параметров. Ваша частная информация и история отправок может отличаться от общей картины Сервиса. «Токсичный» адрес для вашего списка (Рассылки) может быть самым активным клиентом, в то время как на все остальные рассылки, например, он нажимает кнопку «спам», поэтому был исключен из списка. Не отправляйте в проверку адреса, в которых вы уверены.
Единичная проверка осуществляется только для адресов указанных в документации, все остальные адреса возвращаются как fX.
fX — условно-валидные адреса, почтовая история которых Сервису неизвестна (они могут быть, например, заведомо «сгенеренными» или скачанными из сети, и т.п.) — для этих адресов рекомендована «Полная проверка», в АПИ ее можно осуществить через метод проверки списков (батч).
Мы категорически не рекомендуем производить рассылки по базам адресов категории fХ не прошедшим «Полную проверку»!
fX — условно-валидные адреса, почтовая история которых Сервису неизвестна (они могут быть, например, заведомо «сгенеренными» или скачанными из сети, и т.п.) — для этих адресов рекомендована «Полная проверка», в АПИ ее можно осуществить через метод проверки списков (батч).
Мы категорически не рекомендуем производить рассылки по базам адресов категории fХ не прошедшим «Полную проверку»!
Если вы не нашли ответ на свой вопрос, вы можете обратиться в Службу поддержки по адресу request@mailvalidator.ru