راهنمای زیرساخت ایمیل

ارسال ایمیل با API در Node.js

یک الگوی سمت سرور برای ارسال ایمیل تراکنشی از Node.js بدون لو رفتن کلیدهای API.

در برنامه‌های Node.js، ارسال ایمیل باید پشت یک ماژول سمت سرور یا یک worker پردازش job انجام شود. این ماژول درخواست پیام اعتبارسنجی‌شده را دریافت می‌کند، API ایمیل را فراخوانی می‌کند و پاسخ ارائه‌دهنده را برای قابلیت مشاهده‌پذیری (observability) ذخیره می‌کند.

این در عمل چه معنایی دارد

  • اعتبارنامه‌های API فقط در سمت سرور
  • اعتبارسنجی ورودی پیش از ارسال
  • سیاست timeout و تلاش مجدد
  • ذخیره شناسه پیام‌ها برای پشتیبانی و ممیزی

چک‌لیست پیاده‌سازی

  1. کلید API را از یک متغیر محیطی سرور بخوانید.
  2. فیلدهای فرستنده، گیرنده، موضوع و محتوا را اعتبارسنجی کنید.
  3. API ایمیل را از یک ماژول سرویس یا یک worker صف فراخوانی کنید.
  4. شناسه پیام بازگشتی را همراه با رویداد محصول ذخیره کنید.
  5. فقط خطاهایی را دوباره تلاش کنید که موقتی بودنشان مشخص است.

پرسش‌هایی که تیم‌ها می‌پرسند

آیا می‌توانم API ایمیل را از JavaScript مرورگر فراخوانی کنم؟

کلید API ارسال را در کد مرورگر قرار ندهید. به‌جای آن، ایمیل را از طریق بک‌اند Node.js خود ارسال کنید.

آیا ارسال ایمیل باید درخواست وب را مسدود کند؟

برای اقدامات حیاتی ممکن است چنین باشد، اما صف‌ها معمولاً برای تلاش مجدد و تاب‌آوری گزینه بهتری هستند.