Если вам необходимо отправлять электронные письма из приложения, стоит заранее подумать о том, как ваши потребности будут меняться со временем. Как и во многих технологических решениях, здесь существует компромисс между эффективностью на старте и долгосрочной гибкостью.
У вас есть два основных варианта отправки писем из вашего Python-приложения. Первый — это SMTP, стандартный протокол для исходящей электронной почты. Второй вариант позволяет обойти сложности SMTP за счет использования API почтового провайдера для получения более широких возможностей.
В этой статье сравнивается отправка электронной почты на Python с использованием SMTP и API. SMTP прост в настройке — особенно с такой библиотекой, как smtplib, — но он не сможет масштабироваться по мере роста вашего приложения, подвергает вас риску попадания в спам-фильтры и сильно усложняет диагностику проблем. Настройка через API занимает чуть больше времени, но окупается за счет функций, которые вы можете использовать самым разным образом.
Экономный подход с SMTP #
SMTP — это базовый универсальный протокол для отправки электронной почты. Прямая реализация SMTP — это максимум, что вы можете сделать своими силами в мире почты, но даже для самой простой схемы отправки все равно требуется сторонний SMTP-сервер.
Технически вы можете запустить собственный SMTP-сервер, но это редко бывает оправданно. Почтовые провайдеры уделяют пристальное внимание репутации отправителя, чтобы решать, какие письма пропускать в папку «Входящие». Надежный SMTP-сервис помогает гарантировать, что ваши письма действительно дойдут до адресата. В приведенном ниже коде используются SMTP-серверы Postmark.
Быстрый старт с привычными инструментами (такими как smtplib) #
Отправка писем через SMTP проста и очень похожа в любом приложении. Преимущество после настройки заключается в том, что вы можете попробовать новый сервис без полного переписывания приложения — вы можете менять SMTP-провайдеров, используя тот же код.
Чтобы реализовать SMTP в Python-приложении, воспользуйтесь встроенной библиотекой smtplib и выполните следующие действия:
1. Импортируйте smtplib
Вам не нужно устанавливать какие-либо новые библиотеки — модуль SMTP входит в стандартную поставку Python. Просто импортируйте его вместе с MIMEText, который помогает форматировать электронную почту:
2. Настройте SMTP-сервер
Структура этой части кода остается неизменной для всех SMTP-серверов и учетных записей, но вы должны указать свои данные и учетные данные:
Хотя в этом примере мы так не делали, рекомендуется сохранять учетные данные в виде переменных окружения, чтобы они не «светились» в публичном коде.
3. Создайте электронное письмо
Указанные выше переменные можно использовать повторно в нескольких функциях отправки писем. Каждая функция должна создавать объект письма:
4. Отправьте электронное письмо
Соберите все части воедино в вашем скрипте:
Этот скрипт легко адаптируется и гибк, в пределах ограничений самого SMTP.
Будьте готовы к трудностям роста #
SMTP — прекрасное место для старта, но он не будет легко масштабироваться по мере роста размера и сложности вашего приложения.
Буква «S» в аббревиатуре SMTP означает «простой» (simple), но она также могла бы означать «самостоятельный» (self-serve). По сравнению с использованием API, прямая реализация SMTP предлагает меньше возможностей и меньшую наблюдаемость.
SMTP не предлагает автоматических повторных попыток отправки, пакетной обработки или постановки в очередь — всего того, что может существенно повысить доставляемость. Если доставка не удалась, он не поможет вам выяснить причину. Вы можете написать эти функции самостоятельно, но это потребует экспертизы во многих аспектах архитектуры приложений и работы электронной почты.
SMTP — хорошая технология для изучения, и она может быть полезна для простых приложений. Но для многих разработчиков создание многофункционального приложения на базе SMTP не стоит потраченных усилий.
Получите гибкость и возможности с помощью API #
Второй путь — интеграция с надежным почтовым сервисом вроде Postmark через его API. Вы по-прежнему задействуете их SMTP-серверы, но вдобавок получаете доступ к структурированным инструментам, логам и отчетам, которые делают ваше приложение более гибким и незаменимым по мере его масштабирования.
Почтовый API преобразует запросы от вашего приложения в инструкции для сети связанных SMTP-серверов и других сопутствующих служб.
Представьте, что вы привезли кучу посылок в бизнес-центр, где сотрудник за стойкой определяет наиболее подходящий и надежный сервис для ваших нужд. API — это больше, чем просто курьер; это агрегатор услуг, открывающий функциональность, которую не в силах предоставить один лишь SMTP.
SDK ускоряют настройку #
Безусловно, вы можете вызывать API напрямую из своего приложения. В современном Python-приложении вы, скорее всего, будете использовать модуль requests. Это проторенная дорожка, и для ее реализации потребуется совсем немного усилий.
Однако кодовая база, изобилующая HTTP-запросами, может быстро превратиться в хаос, а ее настройка может отнять много времени, особенно если вы собираетесь использовать ее в разных частях приложения.
SDK ускоряют процесс настройки, помогают открывать новые возможности и снижают риск появления ошибок в коде. В Python работа с SDK часто помогает сделать кодовую базу более «питонистичной» — более чистой, лаконичной и читаемой.
Чтобы использовать новый Python SDK от Postmark для отправки одного письма, выполните следующие действия:
1. Установите Python SDK
У Postmark есть SDK для самых разных языков программирования: некоторые поддерживаются официально, другие развиваются сообществом Postmark.
Для работы с Python-приложением скачайте пакет здесь и настройте свои учетные данные.
Сохраните учетные данные и адрес электронной почты отправителя в качестве переменных окружения.
2. Импортируйте модули
В файле, откуда вы планируете отправлять письмо, импортируйте следующие модули и загрузите переменные окружения:
3. Создайте функцию отправки письма
API предлагает гораздо больше возможностей отправки, чем один лишь SMTP, например шаблоны, отслеживание возвратов и массовую рассылку. Если вы выберете этот путь, изучите доступные функции. Вот самая базовая функция отправки письма:
До сих пор мы делали в основном то же самое, что и с smtplib выше. Но использование API дает два ключевых преимущества.
Во-первых, встроенный класс Email гарантирует, что ваши сообщения правильно отформатированы, что увеличивает вероятность успешной доставки. Во-вторых, API дает вам доступ к кодам ответов.
4. Получите подтверждение
Одна из самых ценных причин использовать API — это наблюдаемость: вы получаете гораздо больше информации о том, что происходит после отправки письма.
Приведенный выше метод отправки обернут в асинхронную функцию, которая возвращает ответ от API. Если письмо отправлено успешно, ответ выглядит следующим образом:
Даже при таком базовом уровне отслеживания вы уже имеете гораздо больше представления о том, что произошло с вашим письмом, чем при использовании SMTP.
Другие поля в классе Email предоставляют еще больше подробностей, например, открыл ли получатель письмо или переходил по ссылкам — эту информацию можно получить, отправив MessageID в эндпоинт Messages. Эндпоинт Stats агрегирует данные по всем отправленным сообщениям, позволяя отслеживать тренды.
Создавайте масштабируемую и гибкую почтовую функциональность #
Настройка API, безусловно, требует больше работы, чем прямая настройка SMTP, но отдача от затраченного времени оказывается значительно выше.
API может предоставить вам доступ к таким функциям, как массовая и запланированная отправка, вебхуки для мониторинга поведения и ошибок, а также автоматический повтор отправки — ничего из этого недоступно при использовании только SMTP. Подобные функции позволяют создать более надежную почтовую систему, которая сможет развиваться вместе с вашим приложением.
Пересматривайте подход по мере роста #
Выбор наилучшего способа реализации отправки электронной почты означает постоянный контроль над вашими потребностями по мере их развития. Ваше приложение, скорее всего, со временем будет расти, поэтому обращайте внимание на меняющиеся сценарии использования и не придерживайтесь метода, который вам больше не подходит.
Если вы еще не готовы инвестировать в настройку API, SMTP может стать отличным началом. Но вы можете в любой момент изменить метод отправки писем, будь то переход с SMTP на API или смена поставщика услуг электронной почты. Это может оказаться гораздо проще, чем вы ожидает, а преимущества могут быть значительными.
