APIهای ایمیل · 21 سپتامبر 2026
APIهای ایمیل سازگار با Resend: آنچه سازگاری پوشش نمی‌دهد
سازگاری API به شما اجازه می‌دهد بدون بازنویسی کد ارائه‌دهنده را عوض کنید، اما اعتبار، رکوردهای DNS یا سابقه تحویل‌پذیری شما را منتقل نمی‌کند.
سازگاری API در واقع یعنی چه
For email developers, Resend-compatible mail APIs implement the same request and response schemas as the provider they replace. If you use a Resend-compatible API, you can change your base URL and API key in your environment variables and your POST /emails calls will still work. It covers the syntax of the payload, the HTTP status codes, and the structure of the JSON response. It does not cover your sender reputation, your DNS configuration, your IP warm up, or your billing structure.
به‌عنوان مهندسی که صف رخدادها را مدیریت می‌کند، تیم‌هایی را دیده‌ام که تصور می‌کنند "سازگاری" یعنی مهاجرت با یک کلیک. این‌طور نیست. شما رابط را منتقل می‌کنید، نه زیرساخت را.
رابط: چه چیزی پوشش داده می‌شود
وقتی ارائه‌دهنده‌ای ادعای سازگاری با Resend را دارد، معمولاً endpoint اصلی ارسال را بازسازی کرده است. این به شما اجازه می‌دهد payloadی مانند این را بفرستید:
{
"from": "onboarding@example.com",
"to": "user@gmail.com",
"subject": "Welcome to the App",
"html": "<strong>Hello!</strong>"
}
اگر API سازگار باشد، سرور یک 200 OK یا 201 Created همراه با شناسه پیام برمی‌گرداند. این بخش "آسان" ماجراست. نیازی به بازنویسی منطق یکپارچه‌سازی یا تغییر SDKها نخواهید داشت. برای تیم‌هایی که ایجنت هوش مصنوعی می‌سازند، این ثبات حیاتی است. وقتی ایجنت‌ها از طریق یک سرور MCP یا یک کارت A2A ایمیل ارسال می‌کنند، برای اطمینان از اینکه اثر جانبی (ارسال ایمیل) واقعاً رخ داده، به schemaهای قابل‌پیش‌بینی متکی‌اند.
زیرساخت: چه چیزی پوشش داده نمی‌شود
سازگاری در لایه HTTP به پایان می‌رسد. هر آنچه پس از پذیرش درخواست توسط API رخ می‌دهد، به ارائه‌دهنده وابسته است.
1. DNS و تأیید دامنه
کلید API شما مجوز دامنه‌تان را با خود نمی‌آورد. نمی‌توانید فقط URL را عوض کنید و انتظار داشته باشید ایمیل‌هایتان احراز هویت شوند. باید دامنه خود را نزد ارائه‌دهنده جدید دوباره تأیید کنید. این کار شامل افزودن رکوردهای جدید SPF، DKIM و DMARC به DNS شماست.
اگر به‌روزرسانی این‌ها را فراموش کنید، ایمیل‌هایتان احتمالاً رد می‌شوند یا اسپم علامت می‌خورند، چون ارائه‌دهنده جدید مجاز به ارسال از طرف شما نیست. پیش از تغییر نهایی، می‌توانید با بررسی DNS ایمیل SendHQ مطمئن شوید رکوردهایتان به‌درستی منتشر شده‌اند.
2. اعتبار فرستنده و گرم‌کردن IP
اعتبار به IP ارسال و دامنه گره خورده است. اگر از یک ارائه‌دهنده به دیگری منتقل شوید، اغلب به مجموعه جدیدی از IPهای اشتراکی منتقل می‌شوید. حتی اگر دامنه شما اعتبار عالی داشته باشد، IP جدید ممکن است "سرد" باشد یا بدتر از آن، با یک فرستنده مخرب به اشتراک گذاشته شده باشد.
پذیرش توسط ارائه‌دهنده (اینکه API بگوید "OK") با تحویل (پذیرش ایمیل توسط سرور گیرنده) فرق دارد و آن هم با رسیدن به صندوق ورودی (قرار گرفتن ایمیل در پوشه اصلی) متفاوت است. سازگاری پذیرش توسط ارائه‌دهنده را پوشش می‌دهد و هیچ کمکی به تحویل یا رسیدن به صندوق ورودی نمی‌کند.
3. وب‌هوک‌ها و schema رویدادها
حتی اگر API ارسال سازگار باشد، رویدادهای وب‌هوک (delivered، bounced، complained) اغلب سازگار نیستند. اگر سیستم شما برای اجرای منطق پیگیری به ردیابی رویدادهای تحویل متکی است، باید payloadهای وب‌هوک ارائه‌دهنده جدید را بازبینی کنید. رویداد bounce در یک سیستم ممکن است در سیستم دیگر hard_bounce باشد.
هزینه سازگاری: واقعیت‌های قیمت‌گذاری
سازگاری به شما امکان می‌دهد بدون هزینه بازنویسی کامل، به دنبال قیمت بهتر باشید. با این حال، مدل‌های قیمت‌گذاری بسیار متفاوت‌اند. بر اساس داده‌های سپتامبر 2026:
- Amazon SES: رقابتی‌ترین قیمت‌گذاری. مدل a la carte برابر 0.10 USD به‌ازای هر 1,000 ایمیل است (قیمت‌گذاری Amazon SES). پلن‌های سطح‌بندی‌شده جدید که در 21 ژوئیه 2026 معرفی شدند شامل Essentials (0.16 USD به‌ازای هر 1,000)، Pro (0.22 USD به‌ازای هر 1,000 به‌علاوه 105 USD در ماه برای هر region) و Enterprise (0.23 USD به‌ازای هر 1,000 به‌علاوه 500 USD در ماه) هستند.
- Resend: سطح رایگانی با 3,000 ایمیل در ماه (با سقف 100 ایمیل در روز) ارائه می‌دهد. پلن Pro ماهانه 20 USD برای 50,000 ایمیل است و مصرف مازاد 0.90 USD به‌ازای هر 1,000 محاسبه می‌شود (قیمت‌گذاری Resend).
- Postmark: ماهانه 15 USD برای 10,000 ایمیل، با مصرف مازاد بین 1.80 تا 1.20 USD به‌ازای هر 1,000 (قیمت‌گذاری Postmark).
- Mailgun: ماهانه 15 USD برای 10,000 ایمیل، با مصرف مازاد بین 1.80 تا 1.10 USD به‌ازای هر 1,000 (قیمت‌گذاری Mailgun).
- SendGrid: سطح رایگان اکنون یک دوره آزمایشی 60 روزه است و پلن Essentials از 19.95 USD در ماه شروع می‌شود (قیمت‌گذاری SendGrid).
برای درک بهتر: ارسال 50,000 ایمیل در SES با مدل a la carte حدود 5 USD هزینه دارد، اما در سطوح Postmark حدود 66 USD. سازگاری API این بهینه‌سازی هزینه را بدون یک ماه کار مهندسی ممکن می‌کند.
مهندسی برای قابلیت اطمینان و ایجنت‌ها
وقتی ایمیل را یک اثر جانبی خارجی در نظر می‌گیرید، به‌ویژه هنگام استفاده از ایجنت‌های هوش مصنوعی، باید شکست را هم در نظر بگیرید. اینکه API پاسخ 200 OK برگرداند به این معنا نیست که ایمیل به کاربر رسیده است.
Idempotency
اگر ایجنتی به‌دلیل timeout درخواستی را دوباره تلاش کند، ممکن است یک ایمیل دو بار ارسال شود. این تجربه کاربری بدی است. باید از یک کلید idempotency در هدرهای خود استفاده کنید. این کار تضمین می‌کند اگر یک درخواست دو بار ارسال شود، ارائه‌دهنده فقط یک ایمیل بفرستد.
گردش‌کارهای تأیید
ایجنت‌ها نباید دسترسی نامحدود به سهمیه ارسال شما داشته باشند. برای ارسال‌های پرحجم یک لایه تأیید پیاده‌سازی کنید. یک چک‌لیست ساده برای ایمیل‌هایی که ایجنت ارسال می‌کند:
- اعتبارسنجی schema: آیا payload با مشخصات API سازگار مطابقت دارد؟
- محدودیت نرخ: آیا ایجنت از سقف روزانه (مثلاً محدودیت رایگان 100 ایمیل در روز Resend) فراتر می‌رود؟
- Idempotency: آیا برای این تراکنش مشخص یک کلید یکتا وجود دارد؟
- انسان در حلقه: آیا این ایمیل پیش از فراخوانی API به تأیید دستی نیاز دارد؟
چک‌لیست مهاجرت
اگر به یک ارائه‌دهنده سازگار با Resend مهاجرت می‌کنید، برای جلوگیری از فروپاشی تحویل این ترتیب را دنبال کنید:
- راه‌اندازی DNS: SPF، DKIM و DMARC را پیکربندی کنید. برای اطمینان از اینکه رکوردی را جا نینداخته‌اید، راهنمای ما درباره احراز هویت ایمیل را بخوانید.
- تأیید: با یک ابزار، انتشار DNS را تأیید کنید.
- گرم‌کردن (warm-up): اگر حجم بالایی ارسال می‌کنید، ترافیک را تدریجاً از ارائه‌دهنده قدیمی به ارائه‌دهنده جدید منتقل کنید. 100% ترافیک را در یک ساعت منتقل نکنید.
- ممیزی وب‌هوک: نوع رویدادهای ارائه‌دهنده جدید را به schemaهای داخلی پایگاه داده خود نگاشت کنید.
- مدیریت خطا: نحوه مدیریت ایمیل‌های نامعتبر توسط ارائه‌دهنده جدید را آزمایش کنید. آیا یک
400برمی‌گرداند یا یک202به‌همراه رویداد برگشت بعدی؟
خلاصه بده‌بستان‌ها
ویژگی | پوشش توسط سازگاری؟ | اقدام لازم
payload درخواست | بله | هیچ (اگر مشخصات مطابقت داشته باشد)
قالب پاسخ | بله | هیچ (اگر مشخصات مطابقت داشته باشد)
احراز هویت دامنه | خیر | به‌روزرسانی رکوردهای DNS
اعتبار IP | خیر | دوره گرم‌کردن
قیمت‌گذاری/سهمیه‌ها | خیر | بررسی صفحات قیمت‌گذاری ارائه‌دهنده
رویدادهای وب‌هوک | خیر | به‌روزرسانی listenerهای رویداد
سازگاری ابزاری برای چابکی است، نه عصای جادویی تحویل‌پذیری. با جدا کردن رابط از زیرساخت، می‌توانید هزینه و کارایی را بهینه کنید، بدون اینکه در اکوسیستم یک ارائه‌دهنده واحد گرفتار شوید.
برای یک API ایمیل آماده ایجنت با حداقل داده از نظر حریم خصوصی که این زیرساخت را ساده می‌کند، SendHQ را ببینید.