Руководство по почтовой инфраструктуре
Email API на Node.js
Серверный шаблон отправки транзакционных писем из Node.js без утечки API-ключей.
В приложениях на Node.js отправка писем должна находиться в серверном модуле или воркере фоновых задач. Модуль получает проверенный запрос на отправку, вызывает email API и сохраняет ответ провайдера для наблюдаемости.
Что это значит на практике
- Учётные данные API — только на сервере
- Проверка входных данных перед отправкой
- Политика тайм-аутов и повторных попыток
- Сохранённые идентификаторы писем для поддержки и аудита
Чек-лист внедрения
- Считывайте API-ключ из переменной окружения на сервере.
- Проверяйте поля отправителя, получателя, темы и содержимого.
- Вызывайте email API из сервисного модуля или воркера очереди.
- Сохраняйте возвращённый ID письма вместе с событием продукта.
- Повторяйте только те ошибки, которые заведомо временные.
Что спрашивают команды
Можно ли вызывать email API из JavaScript в браузере?
Не раскрывайте API-ключ для отправки в браузерном коде. Отправляйте письма через бэкенд на Node.js.
Должна ли отправка письма блокировать веб-запрос?
Для критичных действий — может, но для повторных попыток и отказоустойчивости обычно лучше подходят очереди.