MailLandDocs
E-posta Gönderimi

SMTP Relay

Standart SMTP protokolleri kullanarak Mail.Land SMTP relay üzerinden e-posta gönderin

MailLand, SMTP aracılığıyla e-posta gönderen uygulamalar için bir SMTP relay hizmeti sunar. Standart SMTP portları üzerinden kimlik doğrulaması yapmak ve göndermek için aynı API kimlik bilgilerini kullanın.

Bağlantı Ayarları

AyarDeğer
Sunucusmtp.mail.land
Port 587STARTTLS ile gönderim (zorunlu)
Kimlik DoğrulamaZorunlu
Kullanıcı AdıHerhangi bir değer (örn. e-posta adresiniz veya apikey)
ParolaMailLand API anahtarınız
Maksimum mesaj boyutu15 MiB (15.728.640 bayt); daha büyük mesajlar 552 ile reddedilir

Üretimde relay için yalnızca port 587 (STARTTLS) yayınlanır. Port 465 (örtük TLS) yayınlanmaz ve port 25, relay'e değil ayrı gelen kutusu ağ geçidine yönlendirilir.

Kimlik Doğrulama

SMTP kimlik doğrulaması, MailLand API anahtarınızı parola olarak kullanır. Kullanıcı adı herhangi bir değer olabilir: MailLand bunu dikkate almaz ve yalnızca API anahtarına göre kimlik doğrulaması yapar.

Kimlik bilginizde Smtp kanalı etkin olmalıdır. Kimlik bilginizde yalnızca Api etkinse, SMTP kimlik doğrulaması reddedilir.

Username: apikey
Password: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

Hesap e-postanız ve parolanız SMTP için kabul edilmez. Panelde bir SMTP kimlik bilgisi oluşturun ve parola olarak onu kullanın.

Yapılandırma Örnekleri

nodemailer-config.js
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.',
});

Kimlik Bilgisi Kuralları

REST API ile aynı kimlik bilgisi kuralları SMTP için de geçerlidir:

  • Akış: işlemsel kimlik bilgileri mesaj başına 5 alıcı ile sınırlıdır; pazarlama kimlik bilgileri mesaj başına 1.000 alıcıya kadar izin verir
  • Alan adı kapsamı: kimlik bilgisi belirli alan adlarıyla sınırlandırılmışsa, gönderici alan adı izin verilen listede olmalıdır
  • IP beyaz listesi: kimlik bilgisinde IP kısıtlaması varsa, bağlanan IP izin verilenler arasında olmalıdır
  • Hız sınırları: kimlik bilgisinin dakika (ayarlıysa), saat (varsayılan 1.000) ve gün (varsayılan 10.000) sınırları, workspace'in plan sınırlarından önce uygulanır. Birinin aşılması geçici bir 421 döner. Saniye başına sınır bugün uygulanmıyor
  • Mod: sandbox kimlik bilgileri e-postayı kabul edip kaydeder ancak sandboxBehavior ne olursa olsun asla teslim etmez

IP Bağlantı Sınırları

Kimlik bilgisi hız sınırlarından bağımsız olarak, SMTP bağlantıları IP adresi bazında hız sınırlıdır:

SınırVarsayılan
Dakika başına bağlantı30
Saat başına bağlantı300

Bu sınırlar kimlik doğrulamadan önce uygulanır. Aşılması durumunda bağlantı, daha sonra yeniden denenmesi yönünde bir mesajla reddedilir.

SMTP Yanıt Kodları

KodAnlamı
250Mesaj teslim için kabul edildi
421Geçici: kimlik bilgisi veya workspace hız sınırı, kota veya ısınma temposu aşıldı. Daha sonra tekrar deneyin; bu kalıcı bir ret değildir
451Geçici: gönderim bir hacim artışı, pazarlama duraklatması veya teslimat askıya alması nedeniyle duraklatıldı. Mesajı kuyrukta tutun ve tekrar deneyin; duraklatma kaldırıldığında kabul edilir
550Kalıcı: alan adı doğrulanmamış, gönderici/alıcı engellenmiş, doğrulama gerekiyor veya pazarlama alıcı sınırı (mesaj başına 1.000) aşıldı veya tüm alıcılar bastırılmış (5.7.1)
552Kalıcı: mesaj maksimum boyutu (15 MiB) aşıyor, ekler çözüldükten sonra toplamda 10 MiB'ı aşıyor veya birleştirilmiş mesaj platformun mesaj bütçesini aşıyor (5.3.4)

Hata İşleme

Bir mesaj reddedildiğinde, SMTP yanıtı okunabilir bir neden içerir. Geçici (tekrar denenebilir) bir ret şöyle görünür:

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

Kalıcı bir ret ise şöyle görünür:

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

REST API'nin aksine (ki 202 Accepted döndürüp eşzamansız olarak işler), SMTP alan adı, hız sınırı ve kota ihlallerini bağlantı düzeyinde eşzamanlı olarak reddedebilir.

SMTP ile REST API Karşılaştırması

ÖzellikREST APISMTP Relay
ProtokolHTTPSSMTP
Kimlik DoğrulamaX-API-Key başlığıSMTP AUTH (anahtar parola olarak)
YanıtEşzamansız (202 Accepted)Eşzamanlı (250 OK veya hata)
EklerJSON içinde Base64Standart MIME
ŞablonlartemplateId alanıDesteklenmez (MIME kullanın)
Zamanlanmış gönderimscheduledAt alanıDesteklenmez
İzlemetracking alanıAlan adı bazında yapılandırılır
Alıcıya özel değişkenlerto[].variablesDesteklenmez
Toplu gönderimsend-batch endpoint'iDesteklenmez

Sonraki Adımlar

Bu sayfada