فنی · پاسخ مستند
حالت sandbox در SendGrid چیست؟
حالت sandbox در SendGrid محیطی محدود است که به توسعه‌دهندگان امکان می‌دهد یکپارچه‌سازی‌های API و پیکربندی‌های SMTP را بدون ارسال ایمیل به گیرندگان واقعی آزمایش کنند. در این حالت، سیستم درخواست را اعتبارسنجی میکند و پاسخ موفق برمی‌گرداند، اما ایمیل واقعی به نشانی مقصد تحویل داده نمیشود تا از اسپم تصادفی یا سوءاستفاده در دوره توسعه جلوگیری شود.
سازوکار حالت sandbox
وقتی حسابی در حالت sandbox است، SendGrid فراخوانی API یا درخواست SMTP ورودی را پردازش میکند تا از درستی نحوی payload و اعتبار احراز هویت مطمئن شود. API کد وضعیت 202 Accepted را برمی‌گرداند که نشان می‌دهد درخواست دریافت شده است. با این حال، عامل انتقال ایمیل پیام را به اینترنت خارجی relay نمی‌کند. این کار به توسعه‌دهندگان امکان می‌دهد منطق کد و مدیریت خطای خود را بدون به خطر انداختن اعتبار فرستنده یا پرداخت هزینه بررسی کنند.
الزامات تأیید
برای خارج شدن از حالت sandbox، کاربران باید یک فرایند تأیید را کامل کنند. این فرایند معمولاً شامل ارائه جزئیات حساب و تأیید یک هویت فرستنده است. SendGrid این گام را برای کاهش خطر استفاده از پلتفرم برای اهداف مخرب الزامی میکند. تا زمانی که حساب کاملاً تأیید نشده، هر تلاشی برای ارسال ایمیل به نشانی‌های تأییدنشده باعث می‌شود پیام کنار گذاشته شود، هرچند API پاسخ موفق برمی‌گرداند.
راهبردهای آزمایش
توسعه‌دهندگان باید از حالت sandbox برای آزمایش یکپارچه‌سازی برنامه خود با API SendGrid استفاده کنند. پس از تأیید موفق بودن پاسخ‌های API، گام بعدی تأیید یک نشانی ایمیل فرستنده یا یک دامنه کامل است. ابزارهای رایگان SendHQ به توسعه‌دهندگان کمک می‌کنند پیش از رفتن به محیط عملیاتی مطمئن شوند رکوردهای DNS درست پیکربندی شده‌اند تا از شکست تحویل جلوگیری شود.
انتقال به محیط عملیاتی
انتقال به محیط عملیاتی مستلزم تکمیل فرایند فعال‌سازی حساب و پیکربندی احراز هویت دامنه است. این کار شامل افزودن رکوردهای SPF و DKIM به تنظیمات DNS دامنه ارسال‌کننده است. پس از تغییر وضعیت حساب از sandbox به فعال، ایمیل‌ها به گیرندگان واقعی مسیریابی میشوند. توسعه‌دهندگان باید پیش از ارسال به کل فهرست کاربران، یک آزمایش نهایی با یک نشانی داخلی شناخته‌شده انجام دهند.
پرسش‌هایی که تیم‌ها می‌پرسند
چرا پاسخ 202 می‌گیرم اما ایمیلی نمی‌رسد؟
این رفتار مورد انتظار حالت sandbox است. وضعیت 202 یعنی درخواست API معتبر بوده، اما ایمیل تحویل داده نشده چون حساب هنوز محدود است.
چگونه حالت sandbox را غیرفعال کنم؟
باید فرایند تأیید حساب را کامل کنید و اطلاعات کسبوکار درخواستشده را برای تأیید به تیم SendGrid ارائه دهید.
آیا در حالت sandbox میتوانم به ایمیل خودم بفرستم؟
معمولاً خیر. مگر اینکه نشانی ایمیل بهطور مشخص بهعنوان فرستنده تأیید شده یا بخشی از یک هویت تأییدشده باشد، حالت sandbox تحویل به همه نشانیها را مسدود میکند.
آیا حالت sandbox هزینه دارد؟
خیر، درخواستهایی که در حالت sandbox انجام میشوند جزو سهمیه ارسال ماهانه شما حساب نمیشوند، چون هیچ ایمیل واقعی تحویل داده نمیشود.
منابع اصلی
- مستندات SendGrid — Twilio SendGrid
- قیمت‌گذاری SendGrid — Twilio SendGrid