Hata Kodları

MailLand API'den dönen her hata yanıtı, makine tarafından okunabilir bir hata kodu içeren code alanı ve insan tarafından okunabilir bir açıklama içeren message alanı içerir.

Hata Yanıt FormatıBölüm bağlantısını kopyala

{
  "code": "DOMAIN_NOT_VERIFIED",
  "message": "Domain is not verified",
  "timestamp": "2026-02-18T12:35:00Z",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Bazı hatalar ek details bilgisi içerir:

{
  "code": "IP_RATE_LIMIT_EXCEEDED",
  "message": "Too many requests from this IP. Retry after 45 seconds.",
  "details": {
    "limit": 300,
    "current": 301,
    "retryAfter": 45,
    "resetAt": "2026-02-18T12:35:00Z"
  }
}

İstek Doğrulama (400)Bölüm bağlantısını kopyala

İstek gövdesi, sorgu parametreleri veya başlıklar hatalı biçimlendirilmiş olduğunda veya gerekli alanlar eksik olduğunda döner.

Kimlik Doğrulama (401)Bölüm bağlantısını kopyala

İstek kimlik bilgileri içermediğinde veya kimlik bilgileri geçersiz olduğunda döner.

İki Faktörlü Kimlik DoğrulamaBölüm bağlantısını kopyala

2FA hataları açıklayıcı bir message ile 400 INVALID_REQUEST döndürür (ör. "Invalid code", "2FA is already enabled"). Ayrılmış 2FA hata kodları yoktur, message alanını okuyun.

Yetkilendirme (403)Bölüm bağlantısını kopyala

Kimliği doğrulanmış kullanıcının istenen işlemi gerçekleştirme yetkisi olmadığında döner.

Bulunamadı (404)Bölüm bağlantısını kopyala

İstenen kaynak mevcut olmadığında veya farklı bir çalışma alanına ait olduğunda döner.

Çakışma (409)Bölüm bağlantısını kopyala

İşlem, kaynağın mevcut durumu ile çakıştığında döner.

Alan Adı ve Gönderim (422)Bölüm bağlantısını kopyala

İstek doğru biçimlendirilmiş olmasına rağmen iş mantığı kısıtlamaları nedeniyle işlenemediğinde döner.

Ödeme Gerekli (402)Bölüm bağlantısını kopyala

Çalışma alanının kredi bakiyesi istenen işlemi karşılayamadığında döner.

Hız Sınırlaması (429)Bölüm bağlantısını kopyala

İstek hız sınırlarını aştığında döner. Genellikle Retry-After başlığı içerir; yoksa, hiç beklemeye gerek olmadığını varsaymak yerine üstel geri çekilme uygulayın.

API Hız SınırlarıBölüm bağlantısını kopyala

E-posta Gönderim Hız SınırlarıBölüm bağlantısını kopyala

Platform Kapasitesi (429)Bölüm bağlantısını kopyala

Bu ret yanıtları, yeni gönderimleri şu anda hesap kotanızın değil platformun sınırladığı anlamına gelir. Her biri Retry-After başlıklı bir 429'dur, hiçbir şey kuyruğa alınmamıştır ve aynı isteği yeniden denemek güvenlidir. SMTP üzerinde geçici 421 Try again later: <message> olarak döner. message, API'nin döndürdüğü İngilizce metindir.

Önceden kabul edilmiş e-postalar bu retlerden asla etkilenmez. Diğer 429 yanıtları gibi ele alın: geri çekilin, Retry-After değerine uyun ve yeniden deneyin. Yapılandırılacak veya yükseltilecek bir şey yoktur.

Akış SınırlarıBölüm bağlantısını kopyala

transactional_recipient_limit_exceeded ve marketing_recipient_limit_exceeded 429 değil 400'dür, yukarıdaki İstek Doğrulama bölümüne bakın. BATCH_NOT_ALLOWED_FOR_TRANSACTIONAL de 400'dür: hız sınırlarından bağımsız olarak işlemsel bir kimlik bilgisinde toplu gönderime izin verilmez.

Kota ve FaturalandırmaBölüm bağlantısını kopyala

Politika MotoruBölüm bağlantısını kopyala

Sunucu Hataları (5xx)Bölüm bağlantısını kopyala

Hataların YönetimiBölüm bağlantısını kopyala

Yeniden Deneme StratejisiBölüm bağlantısını kopyala

Hız Sınırı Başlıklarını OkumaBölüm bağlantısını kopyala

Çoğu yanıt X-RateLimit-Limit ve X-RateLimit-Remaining içerir:

IP tabanlı bir 429 ayrıca şunu ekler:

Sonraki AdımlarBölüm bağlantısını kopyala

• Hız Sınırları: ayrıntılı hız sınırı kademeleri ve en iyi uygulamalar
• Kimlik Doğrulama: token ve API key yönetimi
• Değişiklik Günlüğü: API değişikliklerini takip edin