فنی · پاسخ مستند
چگونه کلید API Resend را برای ارسال ایمیل دریافت کنیم؟
برای دریافت کلید API Resend، در Resend حساب کاربری بسازید، در داشبورد به بخش API Keys بروید و روی Create API Key کلیک کنید. از شما خواسته میشود برای کلید نامی انتخاب کنید و سطح دسترسی آن را تعیین کنید؛ سپس کلید محرمانه فقط یک بار نمایش داده میشود.
راه‌اندازی حساب
ابتدا در resend.com حساب کاربری بسازید. پس از ورود، برای دسترسی به داشبورد باید هویت و نشانی ایمیل خود را تأیید کنید. حساب‌های جدید معمولاً با یک پلن رایگان شروع میشوند که ارسال تعداد محدودی ایمیل در روز را مجاز می‌کند. پیش از تلاش برای ساخت اعتبارنامه برای برنامه خود، مطمئن شوید حسابتان کاملاً فعال شده است.
ساخت کلید
در نوار کناری سمت چپ داشبورد Resend به زبانه API Keys بروید. روی دکمه Create API Key کلیک کنید. می‌توانید برای نظم‌دهی، نامی مانند Production یا Staging به کلید بدهید. می‌توانید بین Full Access برای همه عملیات یا Restricted Access برای محدود کردن کلید به اقدامات مشخص انتخاب کنید. پس از ساخت، کلید را فوراً کپی کنید، چون دوباره نمایش داده نمی‌شود.
استفاده از کلید
کلید API را در یک متغیر محیطی مانند RESEND_API_KEY ذخیره کنید تا secretها را مستقیماً در کد منبع ننویسید. برای مقداردهی اولیه کلاینت، از SDK Resend برای Node.js، Python یا دیگر زبان‌های پشتیبانی‌شده استفاده کنید. کلید را به سازنده (constructor) بدهید تا درخواست‌هایتان احراز هویت شوند. اگر چند دامنه را مدیریت می‌کنید، مطمئن شوید کلید دسترسی‌های لازم برای ارسال از آن دامنه‌های تأییدشده را دارد.
تأیید دامنه
کلید API به‌تنهایی برای ارسال در محیط عملیاتی کافی نیست. باید دامنه خود را در بخش Domains اضافه کنید و رکوردهای DNS لازم را پیکربندی کنید. این کار شامل افزودن رکوردهای TXT و CNAME در ارائه‌دهنده DNS برای فعال‌سازی SPF و DKIM است. می‌توانید از ابزارهای رایگان SendHQ در https://sendhq.cc/tools برای مدیریت زیرساخت ایمیل و راه‌اندازی فنی کمک بگیرید.
چرخش کلید و امنیت
اگر کلیدی لو رفت، فوراً آن را از داشبورد باطل کنید و کلید جدیدی بسازید. یک سیاست چرخش کلید برای به‌روزرسانی دوره‌ای کلیدها پیاده کنید. از commit کردن کلیدها در مخازن عمومی مانند GitHub پرهیز کنید. برای حفظ امنیت خط لوله ایمیل تراکنشی خود از یک secrets manager یا فایل‌های محیطی رمزگذاری‌شده استفاده کنید.
پرسش‌هایی که تیم‌ها می‌پرسند
آیا میتوانم چند کلید API بسازم؟
بله، Resend اجازه میدهد برای محیطها یا اعضای مختلف تیم چند کلید بسازید تا کنترل دقیقی بر دسترسیها داشته باشید.
اگر کلید API خود را گم کنم چه میشود؟
Resend متن ساده کلید را پس از ساخت ذخیره نمیکند. اگر کلید را گم کردید، باید کلید موجود را حذف کنید و کلید جدیدی بسازید.
آیا ساخت کلید API هزینه دارد؟
ساخت کلید API رایگان است. هزینهها بر اساس حجم ایمیلهای ارسالی و پلن قیمتگذاری انتخابشده محاسبه میشوند.
منابع اصلی
- مستندات Resend — Resend
- قیمتگذاری Resend — Resend