API — Документация biz.mail.ru 1.0
Сервис “Mail.Ru для Бизнеса” предоставляет почту для вашей компании.
Для пользования некоторыми возможностями данного сервиса доступно API по адресу https://biz.mail.ru/api/v1/
. Для доступа к методам API используется протокол
HTTPS. Все ответы API имеют JSON-формат.
Все таймстампы возвращаются в формате ISO 8601, в UTC:
YYYY-MM-DDTHH:MM:SSZ
Для регистрации клиента API, а также в случае возникновения вопросов и предложений следует обратиться в службу поддержки.
Параметры
Некоторые параметры запросов, такие как идентификатор домена, идентификатор пользователя, передаются как часть адреса:
https://biz.mail.ru/api/v1/domain/{domain_id}/users/{user_id}
Остальные параметры передаются в зависимости от типа запроса либо в теле запроса, либо в строке запроса. Для GET-запросов параметры методов передаются в строке запроса.
curl "https://biz.mail.ru/api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830¶meter1=value1¶meter2=value2" GET /api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830¶meter1=value1¶meter2=value2 Host: biz.mail.ru
Для остальных типов запросов параметры методов передаются в теле запроса. Содержимое тела запроса в этом случае определяется типом указанным в заголовке Content-Type запроса:
- application/x-www-form-urlencoded
curl -X POST "https://biz.mail.ru/api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830" -d "parameter1=value1¶meter2=value2" POST /api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830 Host: biz.mail.ru Content-Type: application/x-www-form-urlencoded parameter1=value1¶meter2=value2
- application/json
curl -X POST 'https://biz.mail.ru/api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830' -d '{"parameter1": "value1", "parameter2": "value2"}' -H 'Content-Type: application/json' POST /api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830 Host: biz.mail.ru Content-Type: application/x-www-form-urlencoded {"parameter1": "value1", "parameter2": "value2"}
- multipart/form-data
curl -X POST "https://biz. mail.ru/api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830" -F "parameter1=value1" -F "parameter2=value2" POST /api/v1/test?access_token=5c918ed51f38749782b8b2c3ad41a265e560661137363830' Host: biz.mail.ru Content-Type: multipart/form-data; boundary=------------------------------7b1bfd973086 ------------------------------7b1bfd973086 Content-Disposition: form-data; name="parameter1" value1 ------------------------------7b1bfd973086 Content-Disposition: form-data; name="parameter2" value2 ------------------------------7b1bfd973086--
Авторизация
Авторизация клиентов API выполняется на основе протокола авторизации OAuth 2.0. В каждом запросе помимо параметров вызываемого метода следует передавать access token. Процедуры получения и обновления access token описаны в главе “OAuth 2.0 Авторизация”.
Примеры
access token можно передавать как часть строки запроса (см. выше) или включать его в заголовок Authorization: Bearer
.
Пример
curl "https://biz.mail.ru/api/v1/domains" -H "Authorization: Bearer 5c918ed51f38749782b8b2c3ad41a265e560661137363830" GET /api/v1/domains Authorization: Bearer 5c918ed51f38749782b8b2c3ad41a265e560661137363830 Host: biz.mail.ru
Ошибки клиента
В случае ошибок клиента возвращается ответ с HTTP-кодом 400.
Ответ
HTTP 400 BAD REQUEST { "code": 0, "message": "Ошибка валидации данных.", "data": { "name": ["Недопустимое имя домена"] } }
Описание полей
Название | Тип | Описание |
---|---|---|
message | String | Текст описания ошибки. |
code | Number | Уникальный код ошибки. |
data | String | Дополнительная информация об ошибке. Может отсутствовать. |
Общие ошибки
code | message |
---|---|
0 | Ошибка валидации данных |
1 | Домен не подтвержден |
2 | В данный момент Вы не можете воспользоваться выбранной услугой |
Для неавторизованных пользователей отдается ответ с HTTP-кодом 403.
HTTP 403 FORBIDDEN { "message": "Authentication credentials were not provided." }
В случае превышения лимита запросов к какому-либо из методов отдается ответ с HTTP-кодом 429.
Действующие ограничения
- Любые запросы с одного IP-адреса (не более 200 запросов в минуту)
- Запросы на добавление домена (не более 50 запросов в минуту)
Отправить много писем — Почта. Справка
- Ограничения на отправку писем
- Требования Яндекса к честным рассылкам
Уточните, на Яндексе находится ваш ящик, с которого вы хотите рассылать письма, или ящики получателей вашей рассылки?
Мой ящик на ЯндексеЯщики получателей моей рассылки на ЯндексеЕсли вы хотите массово рассылать письма вашим партнерам или клиентам, используйте для этого только специальные рассылочные сервисы.
Если с вашего ящика ежедневно будет отправляться большое количество писем — это будет расценено нашей системой безопасности как спам. Чтобы этого не происходило, в Яндекс Почте установлены технические ограничения на отправку писем в сутки.
Обойти или изменить эти ограничения нельзя.Если это произошло, отправка писем из вашего почтового ящика будет заблокирована. Блокируется только отправка писем — входить в Почту и получать письма вы сможете. Блокировка закончится автоматически через 24 часа, если вы не попытаетесь отправить письмо в течение этого времени, — иначе блокировка продлится еще на 24 часа.
Чтобы ваша рассылка доходила получателям на Яндексе и не попадала в папку Спам, соблюдайте Требования Яндекса к честным рассылкам . Нежелательные рассылки следует отличать от честных. Яндекс Почта оставляет за собой право отправлять в Спам либо не принимать совсем письма рассылок, которые не соответствуют обязательным пунктам этого документа. Соблюдение необязательных требований будет значительно понижать вероятность того, что ваши письма попадут в Спам.
Если вы производите рассылку на почтовые ящики на Яндексе и письма были отклонены почтовым сервером Яндекса, вы получите автоматический отчет от сервиса «Mailer-Daemon», в котором указываются причины недоставки и имя сервера, отклонившего дальнейшее движение письма по назначению.
В течение суток можно отправить с одного ящика 500 писем. Если в письме несколько получателей, то письмо каждому из них считается отдельным письмом.
Дополнительно установлены ограничения на количество получателей:
Количество получателей | Ограничение |
---|---|
Суммарно во всех письмах за сутки | 500 |
В одном письме, отправленном через сайт | 50 |
В одном письме, отправленном через почтовую программу или по протоколу SMTP | 35 |
Внимание. Ограничения могут быть сокращены, если Спамоборона заподозрила массовую рассылку шаблонных или однотипных писем, спама, рекламы или коммерческих предложений.
Настоящий документ отражает представление компании «Яндекс» о честных рассылках. Он не является офертой и не влечет за собой никаких обязательств со стороны компании и ее почтовой службы перед сервисами, осуществляющими массовые рассылки.
Документ основан на сложившейся практике крупнейших провайдеров и почтовых служб, соответствует нормам и рекомендациям ASTA, а также «Нормам пользования сетью». Алгоритм разделения рассылок и спама является ноу-хау компании, не публикуется и не обсуждается.
Что должно быть у честной рассылки:
- Процесс подписки:
(Обяз.) Рассылка должна осуществляться только по явному требованию или согласию получателя.
(Обяз.) Адрес получателя рассылки должен быть явным образом подтвержден самим получателем.
При добавлении в рассылочный лист адреса получателей должны пройти валидацию.
- Процесс отказа от подписки:
(Обяз.) В каждом письме должны быть даны четкие инструкции о том, как отписаться от рассылки. При этом процесс отписки не должен требовать от получателя сложных действий, таких как восстановление пароля, регистрация или авторизация. Получатель должен иметь возможность отписаться от рассылки в течение 10 минут.
В теле письма должен быть явно указан адрес подписчика.
- (Обяз.) В письме должен быть использован заголовок
list-unsubscribe
, оформленный по стандарту RFC. При переходе по ссылке из этого заголовка пользователь должен быть моментально отписан от рассылки. (Обяз.) Для отписки необходимо указывать только работающие ссылки.
- Заголовок письма:
Тема сообщения должна быть понятна пользователю и не должна вводить его в заблуждение.
Тема сообщения должна быть одинаковой для всех писем одной рассылки.
(Обяз.) В поле От кого должен быть указан реально существующий электронный адрес, ассоциированный с источником рассылки.
- Корректность сетевой идентификации:
(Обяз.) Программное обеспечение, осуществляющее рассылку, должно проверять полученные ответы. Если принимающий сервер отвечает, что указанного пользователя не существует, то рассылка по этому адресу должна быть приостановлена.
(Обяз.) Хост, осуществляющий рассылку, должен иметь постоянный IP-адрес с корректно настроенным обратным DNS-запросом. При этом регистрационные данные владельца домена должны быть актуальными и доступными публично по протоколу WHOIS.
- Для корректной идентификации доменное имя должно быть содержательным, а не являться автоматическим адресом наподобие
x.y.z.w-in-addr-arpa
илиdsl-4-3-2-1. provider.net
. Хост, осуществляющий рассылку, должен отличаться от хоста, посылающего обычную корреспонденцию.
(Если предыдущее требование невыполнимо.) Доменное имя в поле От кого должно отличаться от доменного имени, используемого для регулярной переписки, и указывать на источник корреспонденции. Например, для домена example.ru уведомления о новых сообщениях на форуме должны отправляться из домена forum.example.ru, а подписка на новости сайта — из домена news.example.ru и т. п.
(Обяз.) Отправитель из поля От кого должен полностью соответствовать адресу пользователя, с данными которого производится авторизация на сервере.
(Обяз.) Все сообщения должны быть подписаны с помощью DKIM. Также для домена должна быть настроена SPF-запись, указывающая, с каких доверенных серверов может отправляться почта этого домена.
Рекомендуется настроить DMARC для домена. Это дополнительная мера, с помощью которой проверяется, что DKIM и SPF принадлежат отправителю, а также формируются отчеты о попытках подделки отправителя.
- Другие требования:
Нельзя изменять информацию об отправителе или о целевой странице для любых ссылок в письмах.
Не рекомендуется использовать сокращенные ссылки.
Все ссылки в тексте должны указываться в виде полного доменного имени: нельзя использовать в качестве ссылок IP-адреса или перекодированные имена доменов (URL Encoded).
- (Обяз.) В письме должны присутствовать стандартные заголовки, используемые при массовых или автоматических рассылках — например,
Precedence: bulk
(junk
,list
,list-unsubscribe
и т. п.). Все ссылки в них должны позволять отписаться от рассылки автоматически. - Заголовки и формат сообщения должны соответствовать требованиям RFC 5322 и стандарту MIME. Кроме того, в сообщении должны присутствовать корректные заголовки
Date
иMessage-ID
. Для каждой части сообщения должна быть указана реально используемая кодировка. Сообщения с текстами в двух кодировках одновременно недопустимы.
Если рассылка осуществляется в формате HTML, в письме недопустимо использовать элементы JavaScript, ActiveX и другие потенциально опасные объекты.
Внимание. Яндекс Почта оставляет за собой право отправлять в Спам либо не принимать совсем письма рассылок, которые не соответствуют обязательным пунктам этого документа. Соблюдение необязательных требований будет значительно понижать вероятность того, что ваши письма попадут в Спам.
Также вы можете ознакомиться с Принципами взаимодействия Яндекса с другими сетями.
писем остаются в папке «Исходящие» не менее одной минуты — Outlook
Твиттер LinkedIn Фейсбук Электронная почта- Статья
- Применимо к:
- Outlook для Microsoft 365, Outlook 2019, Outlook 2016, Outlook 2013, Outlook 2010, Office Outlook 2007, Office Outlook 2003
Исходный номер базы знаний: 2894412
Симптомы
При отправке сообщения электронной почты оно может оставаться в папке «Исходящие» не менее одной минуты до отправки.
Причина
Эта проблема может возникнуть, если у вас есть правило отложенной доставки, настроенное на задержку отправки некоторых или всех сообщений электронной почты.
Решение
Выполните следующие действия, чтобы определить, настроено ли правило отложенной доставки, и если да, то какие критерии для этого правила настроены.
Outlook 2010 или более поздние версии
Щелкните Rules на ленте, а затем щелкните Manage Rules & Alerts .
Выберите каждое правило, указанное на вкладке Правила электронной почты , а затем просмотрите информацию в разделе Описание правила .
Правила, которые задерживают доставку на . Отправка будет иметь отложить доставку на # минут в описании правила.
Дважды щелкните любое правило, чтобы просмотреть критерии, указанные для правила.
При необходимости снимите отсрочку доставки на несколько минут.
Этот параметр включен на следующем рисунке.
Outlook 2007 или более ранние версии
В меню Инструменты щелкните Правила и оповещения .
Выберите каждое правило из списка Правила электронной почты , а затем просмотрите информацию в разделе Описание правила .
Правила, которые задерживают доставку электронной почты на Отправить , будут иметь отложить доставку на # минут в описании правила.
Дважды щелкните любое правило, чтобы просмотреть критерии, указанные для правила.
Minute Mail
Невероятно простой способ оставаться на связи. Отправляйте открытки и подарки вместе с клиентами, друзьями и семьей в вашем сообществе.
Почему выбирают подарки минутной почтой?
Хотя рукописные карточки всегда лучше, они не всегда удобны. Если у вас мало времени или вы отправляете большое количество открыток по почте, Minute Mail Gifts — идеальное решение . Наш инновационный сервис поздравительных открыток позволяет быстро и легко создать идеальную персонализированную поздравительную открытку . Добавьте фотографии и выберите рукописный шрифт для индивидуального подхода. Тогда выберите уникальный и запоминающийся подарок. Мы займемся остальным!
Создайте + отправьте свою первую открытку и подарок бесплатно!
Мы упростили начало работы с Minute Mail Gifts! Чтобы познакомить вас с нашей службой поздравительных открыток , мы предоставляем вашу первую открытку и подарок бесплатно — без риска ! Мы уверены, что как только вы попробуете нас, вам понравится, насколько быстро и легко оставаться на связи и развивать эти важные отношения. С более чем тысячей дизайнов открыток вы обязательно найдете идеальную поздравительную открытку для любого случая.
При первой регистрации вы автоматически получите бесплатную карту и подарок для отправки. Нет необходимости в специальном коде! Кроме того, есть подписка не требуется . После первой открытки просто отправляйте желаемое количество пользовательских открыток и подарков каждый месяц, чтобы восстановить связь с клиентами или связаться с семьей и друзьями. После этого мы будем удобно выставлять вам счета за ваши покупки один раз в месяц. Оптимизируйте способ оставаться на связи и оставайтесь в центре внимания! Начните сегодня.
Как работает служба поздравительных открыток?
Минутные почтовые подарки — это быстрый, веселый, простой и доступный способ укрепить отношения и завоевать доверие клиентов ! Чтобы воспользоваться нашим сервисом, просто выберите одну из наших красиво оформленных карт. (Независимо от того, хотите ли вы поздравить с праздником, хотите сказать спасибо или отправляете поздравления, у нас есть варианты на любой вкус.) Затем выберите один из наших эксклюзивных подарков-сюрпризов и положите его внутрь. Затем персонализируйте свою открытку фотографиями, напишите свое сообщение и адресуйте конверт. Тогда запланируйте или отправьте свою карту прямо сейчас! Мы бережно упакуем вашу открытку и подарок. Затем отправьте его через USPS, используя настоящие марки .
Мы очень рады предложить вам эту замечательную услугу. Мы надеемся, что это вдохновит вас отправлять больше открыток, чем когда-либо. Почему? Потому что мы считаем, что связь с вашим сообществом через постоянную, осязаемую почту — это действительно секрет лояльности клиентов и рефералов .
Если у вас уже есть учетная запись в Magnets USA или LifeLong Gifts, значит, у вас уже есть учетная запись в Minute Mail Gifts! Войдите, используя существующее имя пользователя и пароль.
Отзывы пользователей Minute Mail Gifts
Вот что некоторые из наших клиентов говорят о Minute Mail Gifts: много личных заметок. Я намеренно сделал ведение заметок частью своего бизнеса… Вы можете позвонить по телефону, отправить электронное письмо, но это временные вещи. Когда вы получаете заметку, я обнаружил, что многие люди цепляются за нее. — Грег Кинг (управляющий председатель группы C12)
Я получил гораздо больше отзывов от моих клиентов, которые поблагодарили меня за то, что просто добавили один из многих подарков, которые Minute Mail Gifts может предложить с моей карточкой для заметок. Открытка оказывает огромное влияние, но добавление подарка помогает им запомнить меня. — Бриттани Х.
Пивоваренная компания Twin Creeks начала использовать Minute Mail Gifts в мае 2020 года. Каждая открытка, которую мы отправляем, содержит изображение трех владельцев и сообщение с благодарностью или представлением. Благодаря Minute Mail Gifts среднемесячная рассылка увеличилась на 312%. — Энди Б. (Twin Creeks Brewing)
Я поставил перед собой цель и начал отправлять по 20 открыток в неделю — и произошли одни из самых удивительных вещей. Я видел, что это действительно влияет на людей и на меня самого. У меня были люди, которые буквально преследовали меня по всей парковке, просто чтобы сказать спасибо и сказать, как много [их записка] значит для них. Я видел, как люди сохраняли их на своем столе. Вы никогда не знаете, как особое сообщение может повлиять на людей. — Донни Мартин (президент, Magnets USA)
Часто задаваемые вопросы о подарках Minute Mail
Если у вас остались вопросы, у нас есть информация, которая поможет вам получить максимальную отдачу от подарков Minute Mail. Независимо от того, отправляете ли вы пользовательских карт для личного использования или для деловых целей, вы можете ознакомиться с ответами на часто задаваемые вопросы в разделе часто задаваемых вопросов.