SMTP Relay

MailLand یک SMTP Relay برای برنامه‌هایی که ایمیل را از طریق SMTP ارسال می‌کنند فراهم کرده است. از همان اعتبارنامه‌های API برای احراز هویت و ارسال از طریق پورت‌های استاندارد SMTP استفاده کنید.

تنظیمات اتصالکپی پیوند بخش

احراز هویتکپی پیوند بخش

احراز هویت SMTP از کلید API سرویس MailLand شما به عنوان رمز عبور استفاده می‌کند. نام کاربری می‌تواند هر مقداری باشد: MailLand آن را نادیده می‌گیرد و صرفا بر اساس کلید API احراز هویت انجام می‌دهد.

اعتبارنامه شما باید کانال Smtp فعال داشته باشد. اگر اعتبارنامه شما فقط Api فعال دارد، احراز هویت SMTP رد خواهد شد.

Username: apikey
Password: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

ایمیل و رمز عبور حساب شما برای SMTP پذیرفته نمی‌شود. در پنل یک اعتبارنامهٔ SMTP بسازید و آن را به‌عنوان رمز عبور به کار ببرید.

نمونه‌های پیکربندیکپی پیوند بخش

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.mail.land',
  port: 587,
  secure: false, // STARTTLS
  auth: {
    user: 'apikey',
    pass: 'ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...',
  },
});

await transporter.sendMail({
  from: '"Your App" <[email protected]>',
  to: '[email protected]',
  subject: 'Hello from MailLand',
  html: '<h1>Hello!</h1><p>Sent via SMTP relay.</p>',
  text: 'Hello! Sent via SMTP relay.',
});

اعمال قوانین اعتبارنامهکپی پیوند بخش

همان قوانین اعتبارنامه REST API برای SMTP نیز اعمال می‌شود:

• جریان: اعتبارنامه‌های تراکنشی حداکثر ۵ گیرنده در هر پیام دارند؛ اعتبارنامه‌های بازاریابی تا ۱٬۰۰۰ گیرنده در هر پیام مجازند
• محدوده دامنه: اگر اعتبارنامه به دامنه‌های خاصی محدود شده باشد، دامنه فرستنده باید در لیست مجاز باشد
• لیست سفید IP: اگر اعتبارنامه محدودیت IP داشته باشد، IP متصل شونده باید مجاز باشد
• محدودیت نرخ: محدودیت‌های اعتبارنامه به ازای هر دقیقه (در صورت تنظیم)، هر ساعت (پیش‌فرض ۱٬۰۰۰) و هر روز (پیش‌فرض ۱۰٬۰۰۰) پیش از محدودیت‌های پلن فضای کاری اعمال می‌شوند. عبور از هرکدام، خطای موقتی 421 برمی‌گرداند. محدودیت به ازای هر ثانیه امروز اعمال نمی‌شود
• حالت: اعتبارنامه‌های Sandbox ایمیل را می‌پذیرند و ثبت می‌کنند اما هرگز تحویل نمی‌دهند، صرف‌نظر از sandboxBehavior

محدودیت اتصال IPکپی پیوند بخش

مستقل از محدودیت‌های نرخ اعتبارنامه، اتصالات SMTP بر اساس آدرس IP محدود می‌شوند:

این محدودیت‌ها قبل از احراز هویت اعمال می‌شوند. در صورت تجاوز، اتصال با پیامی مبنی بر تلاش مجدد بعدا رد می‌شود.

کدهای پاسخ SMTPکپی پیوند بخش

مدیریت خطاکپی پیوند بخش

هنگامی که پیامی رد می‌شود، پاسخ SMTP شامل دلیلی قابل‌فهم است. یک رد موقتی (قابل تلاش مجدد) این‌گونه است:

421 Try again later: rate limit exceeded
421 Try again later: monthly quota exceeded
421 Try again later: credential rate limit exceeded
451 4.7.0 Marketing emails are paused for this account

و یک رد دائمی این‌گونه است:

550 5.7.1 Domain is not verified. Add DNS records at https://app.mail.land

مقایسه SMTP و REST APIکپی پیوند بخش

مراحل بعدیکپی پیوند بخش

• REST API: ارسال ایمیل از طریق REST API
• کلیدهای API: پیکربندی کانال SMTP روی اعتبارنامه‌ها
• تنظیمات دامنه: پیکربندی رکوردهای DNS برای دامنه ارسال