راهنمای زیرساخت ایمیل
وبهوکهای ایمیل ورودی: الگوهای طراحی و ایمنی
برای پردازش پیام‌های ورودی از وب‌هوک استفاده کنید، بدون اینکه گردش‌کاری مبتنی بر polling صندوق ایمیل بسازید.
وب‌هوک ایمیل ورودی هنگام رسیدن یک پیام، رویدادی ساخت‌یافته را به اپلیکیشن شما تحویل می‌دهد. چالش طراحی در parse امن، احراز هویت، idempotency و مدیریت تلاش‌های مجدد بدون از دست رفتن پیام‌هاست.
این در عمل چه معنایی دارد
- تحویل وب‌هوک امضاشده یا احراز هویت‌شده
- شناسه‌های پیام برای پردازش idempotent
- نگهداری پیام خام برای بازیابی
- پردازش ناهمگام پیوست‌ها و کارهای پاییندستی
چک‌لیست پیاده‌سازی
- پیش از parse کردن محتوا، منبع وب‌هوک را اعتبارسنجی کنید.
- پیش از هر اثر جانبی، شناسه پیام ارائهدهنده را ذخیره کنید.
- پردازش‌های طولانی پیوست‌ها یا هوش مصنوعی را در صف قرار دهید.
- پاسخ موفقیت را سریع برگردانید و در خطاهای گذرا به‌طور امن تلاش مجدد کنید.
پرسش‌هایی که تیم‌ها می‌پرسند
آیا باید پیوست‌ها را داخل درخواست وب‌هوک پردازش کنم؟
معمولاً نه. پیام را ذخیره کنید و پردازش پیوست را در صف بگذارید تا تأیید دریافت سریع بماند و تلاش مجدد امن باشد.
وبهوکهای تکراری را چگونه مدیریت کنم؟
شناسه پیام ارائهدهنده را یکتا در نظر بگیرید و عملیات پاییندستی را idempotent کنید.