Если вам нужно отправлять электронные письма из приложения, стоит задуматься о том, как ваши потребности будут меняться со временем. Как и в случае со многими технологическими решениями, здесь приходится искать компромисс между эффективностью на старте и долгосрочной гибкостью.
У вас есть два основных способа отправки электронных писем из вашего 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), но она также могла бы означать «самообслуживание». По сравнению с использованием API, прямая реализация SMTP предлагает меньше функций и возможностей для мониторинга.
SMTP не предлагает автоматических повторных попыток, пакетной обработки сообщений или очередей, что может значительно улучшить показатели доставляемости. Если доставка не удалась, протокол не поможет вам выяснить причину. Вы могли бы реализовать эти функции самостоятельно, но это потребовало бы глубоких знаний в архитектуре приложений и работе электронной почты.
SMTP — полезная технология для понимания, и она может быть полезна для простых приложений. Но для многих разработчиков создание многофункционального приложения на базе SMTP не стоит затраченных усилий.
Гибкость и возможности API #
Второй путь — интеграция с надежным почтовым сервисом, таким как Postmark, через его API. Вы по-прежнему используете их SMTP-серверы, но также получаете доступ к структурированным инструментам, логам и отчетам, которые делают ваше приложение более гибким и ценным по мере его масштабирования.
Email 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 или смена поставщика услуг электронной почты. Это может оказаться гораздо проще, чем вы ожидаете, а преимущества могут быть значительными.
