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ı
| Ayar | Değer |
|---|---|
| Sunucu | smtp.mail.land |
| Port 587 | STARTTLS ile gönderim (zorunlu) |
| Kimlik Doğrulama | Zorunlu |
| Kullanıcı Adı | Herhangi bir değer (örn. e-posta adresiniz veya apikey) |
| Parola | MailLand API anahtarınız |
| Maksimum mesaj boyutu | 15 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
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
421döner. Saniye başına sınır bugün uygulanmıyor - Mod: sandbox kimlik bilgileri e-postayı kabul edip kaydeder ancak
sandboxBehaviorne 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ır | Varsayı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ı
| Kod | Anlamı |
|---|---|
250 | Mesaj teslim için kabul edildi |
421 | Geç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 |
451 | Geç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 |
550 | Kalı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) |
552 | Kalı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 accountKalıcı bir ret ise şöyle görünür:
550 5.7.1 Domain is not verified. Add DNS records at https://app.mail.landREST 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ı
| Özellik | REST API | SMTP Relay |
|---|---|---|
| Protokol | HTTPS | SMTP |
| Kimlik Doğrulama | X-API-Key başlığı | SMTP AUTH (anahtar parola olarak) |
| Yanıt | Eşzamansız (202 Accepted) | Eşzamanlı (250 OK veya hata) |
| Ekler | JSON içinde Base64 | Standart MIME |
| Şablonlar | templateId alanı | Desteklenmez (MIME kullanın) |
| Zamanlanmış gönderim | scheduledAt alanı | Desteklenmez |
| İzleme | tracking alanı | Alan adı bazında yapılandırılır |
| Alıcıya özel değişkenler | to[].variables | Desteklenmez |
| Toplu gönderim | send-batch endpoint'i | Desteklenmez |
Sonraki Adımlar
- REST API: REST API ile e-posta gönderin
- API Anahtarları: kimlik bilgilerinizde SMTP kanalını yapılandırın
- Alan Adı Kurulumu: gönderim alan adınız için DNS kayıtlarını yapılandırın