Hızlı Başlangıç

Ön Koşullar

Bir MailLand hesabı (kayıt olun)
Doğrulanmış bir gönderim alan adı
Bir API anahtarı (kimlik bilgisi)

Sandbox kimlik bilgileri de kayıtlı, doğrulanmış bir gönderim alan adı gerektirir. Sıradan alıcılara asla teslim etmezler: Sandbox gönderimi kabul edilip kaydedilir veya yalnızca sandbox izin listenizdeki adreslere (Ayarlar → Sandbox Allow List) teslim edilir. Yeni çalışma alanları doğrulanana kadar bu listeyle sınırlıdır.

İlk E-postanızı Gönderin

API anahtarınızı edinin

Hesabınızı ve çalışma alanınızı oluşturduktan sonra kenar çubuğunda Credentials bölümünü açın ve yeni bir kimlik bilgisi oluşturun:

Ürün: Sending
Mod: Production (veya test için Sandbox)
Akış: Transactional
Kanal: API

API anahtarını kopyalayın: yalnızca bir kez gösterilir. Anahtar şuna benzer:

ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

Ön ek, kimlik bilgisi türünü kodlar:

ml_: tüm MailLand anahtarları bununla başlar
p veya s: Production veya Sandbox modu
e, i veya v, Sending/Email, Inbound veya Validation ürünü (Sending anahtarları ayrıca bir akış harfi taşır: işlemsel için et, pazarlama için em, örn. ml_pet_...)

Bir e-posta gönderin

E-posta ayrıntılarınızla gönderim endpoint'ine bir POST isteği yapın:

curl ile e-posta gönderin

curl -X POST https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "[email protected]",
      "name": "Your App"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "Jane Doe"
      }
    ],
    "subject": "Welcome to our platform",
    "htmlContent": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "textContent": "Welcome! Thanks for signing up."
  }'

Yanıtı kontrol edin

Başarılı bir yanıt, kuyruğa alınan e-posta hakkında ayrıntılarla birlikte 202 Accepted döndürür:

Yanıt: 202 Accepted

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "messageIds": ["t_a1b2c3d4e5f6..."],
  "acceptedRecipients": ["[email protected]"],
  "rejectedRecipients": [],
  "queuedAt": "2026-02-17T10:30:00Z",
  "isSandboxed": false
}

Temel alanlar:

jobId: bu gönderim işlemini izlemek için benzersiz tanımlayıcı
messageIds: bireysel mesaj kimlikleri (işlemsel için t_, pazarlama için m_ ön ekli)
acceptedRecipients: teslim için kabul edilen e-postalar
rejectedRecipients: reddedilen e-postalar (nedenleriyle birlikte)
isSandboxed: istek bir sandbox kimlik bilgisi kullandıysa true: e-posta kaydedildi ancak gönderilmedi veya yalnızca izin listesindeki alıcılara gönderildi

Sık Karşılaşılan Hatalar

Durum	Hata Kodu	Anlamı
`401`	`UNAUTHORIZED`	`X-API-Key` eksik, geçersiz, süresi dolmuş veya iptal edilmiş
`422`	`DOMAIN_NOT_VERIFIED`	Gönderici alan adı doğrulanmamış
`429`	`RATE_LIMIT_EXCEEDED`	Çok fazla istek: `Retry-After` başlığını kontrol edin
`429`	`QUOTA_EXCEEDED`	Aylık gönderim kotası doldu
`429`	`SENDING_BLOCKED`	Hesabınızın doğrulama düzeyi bu gönderime henüz izin vermiyor: doğrulamayı tamamlayın (pazarlama için işletme doğrulaması gerekir)
`403`	`SENDING_BLOCKED`	Bu hesap için gönderim tamamen engellenmiştir. Yeniden denemek yardımcı olmaz; destekle iletişime geçin

Tüm hatalar code ve message alanlarını içeren bir JSON gövdesi döndürür:

Hata Yanıtı

{
  "code": "DOMAIN_NOT_VERIFIED",
  "message": "Domain is not verified",
  "timestamp": "2026-02-17T10:30:00Z",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Sırada Ne Var

REST API Referansı: tüm alanlar ve seçeneklerle tam API dokümantasyonu
SMTP Relay: REST yerine SMTP ile e-posta gönderin
Alan Adı Kurulumu: gönderim alan adınızı ekleyin ve doğrulayın
API Anahtarları: hız sınırları ve IP kısıtlamaları ile kimlik bilgilerini yapılandırın

Hızlı Başlangıç

Ön KoşullarBölüm bağlantısını kopyala

İlk E-postanızı GönderinBölüm bağlantısını kopyala

API anahtarınızı edininBölüm bağlantısını kopyala

Bir e-posta gönderinBölüm bağlantısını kopyala

Yanıtı kontrol edinBölüm bağlantısını kopyala

Sık Karşılaşılan HatalarBölüm bağlantısını kopyala

Sırada Ne VarBölüm bağlantısını kopyala