راهنمای زیرساخت ایمیل
چگونه با API ایمیل ارسال کنیم
رویکردی گام‌به‌گام برای ارسال ایمیل احرازهویت‌شده از طریق API، آزمایش و ایمنی در محیط عملیاتی.
یک درخواست ایمیل در محیط عملیاتی به چیزی بیش از گیرنده و موضوع نیاز دارد: یک فرستنده تأییدشده، قالبی متناسب با هدف، احراز هویت، مدیریت خطا و راهی برای مشاهده نتیجه.
این در عمل چه معنایی دارد
- یک دامنه From تأییدشده
- کلید API محدود به فضای کاری درست
- محتوای ساختاریافته HTML و متنی
- راهبرد تلاش مجدد که از تحویل تکراری جلوگیری می‌کند
چک‌لیست پیاده‌سازی
- یک دامنه تأییدشده بسازید و نشانی فرستنده را انتخاب کنید.
- کلید API را در متغیرهای محیطی سمت سرور ذخیره کنید.
- یک پیام آزمایشی به صندوق ورودی تحت کنترل خودتان بفرستید.
- شناسه پاسخ ارائه‌دهنده را لاگ کنید و پاسخ‌های ناموفق را مدیریت کنید.
- برای jobهایی که دوباره اجرا می‌شوند، کلید idempotency یا شناسه رویداد اضافه کنید.
پرسش‌هایی که تیم‌ها می‌پرسند
آیا باید از کلید API در کد مرورگر استفاده کرد؟
خیر. اعتبارنامههای ارسال را روی سرور، worker یا backend مورد اعتماد نگه دارید.
چگونه از ارسال تکراری ایمیل جلوگیری کنم؟
از یک شناسه رویداد پایدار یا کلید idempotency استفاده کنید و پیش از تلاش مجدد jobهای ناموفق، شناسه پیام ارائه‌دهنده را ذخیره کنید.