ترحيل SMTP

يوفر MailLand ترحيل SMTP للتطبيقات التي ترسل البريد الإلكتروني عبر 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.',
});

قواعد بيانات الاعتمادنسخ رابط القسم

تنطبق نفس قواعد بيانات الاعتماد على SMTP كما على REST API:

• التدفق: بيانات اعتماد المعاملات تحدّ المستلمين بـ 5 لكل رسالة؛ بيانات الاعتماد التسويقية تسمح بحتى 1,000 مستلم لكل رسالة
• نطاق النطاقات: إذا كانت بيانات الاعتماد محددة بنطاقات معينة، يجب أن يكون نطاق المُرسِل في القائمة المسموحة
• قائمة IP المسموحة: إذا كانت بيانات الاعتماد تحتوي على قيود IP، يجب أن يكون عنوان IP المتصل مسموحاً به
• حدود المعدل: تُطبّق حدود بيانات الاعتماد لكل دقيقة (إن وُجدت) ولكل ساعة (الافتراضي 1,000) ولكل يوم (الافتراضي 10,000) قبل حدود خطة مساحة العمل. تجاوز أحدها يُعيد خطأ مؤقتاً 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 لنطاق الإرسال