Gelen Posta Rotaları

Rotalar, MailLand'ın bir alan adı için gelen e-postaları nasıl işleyeceğini tanımlar. Her rota, alıcının yerel kısmıyla (adresin @ işaretinden önceki bölümü) eşleşir ve bir veya daha fazla eylem çalıştırır: depolama, bir webhook'a teslim etme, iletme, SMTP düzeyinde reddetme veya düşürme. Rotalar öncelik sırasına göre (en düşük sayı önce) değerlendirilir ve ilk eşleşen rota kazanır.

Eşleşme TürleriBölüm bağlantısını kopyala

Eşleşme büyük/küçük harfe duyarsızdır ve her zaman yerel kısma karşı çalışır, [email protected] ve [email protected], aynı alan adına sınırlı support kalıbına sahip bir rotayla ikisi de eşleşir.

Rota EylemleriBölüm bağlantısını kopyala

Bir rotanın actions alanı, aşağıdaki dize değerlerinden bir veya daha fazlasının listesidir:

store ve webhook birbiriyle ve forward ile birleştirilebilir. reject, drop ve unsubscribe sonlandırıcıdır: her biri rotadaki tek eylem olmalıdır; API, bunlardan birini başka bir eylemle birleştiren bir isteği reddeder.

Yönlendirme HedefleriBölüm bağlantısını kopyala

Bir adrese herhangi bir posta yönlendirilmeden önce, o adresin sahibinin bunu onaylaması gerekir: yalnızca adres, gönderim için tam olarak doğrulanmış kendi alan adlarınızdan birindeyse bu gerekmez. Dış bir adres için bunu atlamanın bir yolu yoktur: bu, hedef sahibini hiç kabul etmediği postayı almaktan korur ve gönderim itibarınızı geri dönen veya şikayet eden bir adresten korur.

actions içinde forward olan bir rota oluştururken veya güncellerken MailLand otomatik olarak:

1. forwardToEmail için bir yönlendirme hedefi kaydı oluşturur (veya yeniden kullanır), kiracınıza özgü: aynı adres, ona yönlendiren her rota genelinde hatırlanır.
2. Adres onay gerektiriyorsa ve daha önce hiç sorulmadıysa, bir bağlantı içeren onay e-postası gönderir.

Rota kaydının kendisi her zaman başarılı olur; başarısız bir onay e-postası rotayı başarısız kılmaz: hedef, siz onayı yeniden göndermediğiniz sürece basitçe pending kalır (ona hiçbir şey yönlendirilmez).

Onay BağlantısıBölüm bağlantısını kopyala

Onay e-postasındaki bağlantı 7 gün geçerlidir ve tek kullanımlıktır: alıcı onayladıktan veya reddettikten sonra bağlantıyı tekrar ziyaret etmek yalnızca aynı kararı gösterir, tekrar ziyaret edilerek geri alınamaz. Süresi dolmuş, hiç karara bağlanmamış bir bağlantı tekrar açıldığında 410 Gone döner.

• Onayla: bu kiracı için iletilen posta artık adrese gönderilecektir.
• Reddet: kesindir. Bu kiracı için adrese bir daha asla hiçbir şey iletilmez ve kiracı onun için tekrar onay isteyemez.

Bir Yönlendirme Hedefini GetirmeBölüm bağlantısını kopyala

GET https://api.mail.land/v1/transactional/inbound/forward-destinations/{destinationId}

{
  "id": "f2k9m3q7p4w8x1",
  "email": "[email protected]",
  "status": "pending",
  "confirmedVia": null,
  "lastSentAt": "2026-09-26T10:00:00Z",
  "confirmedAt": null,
  "declinedAt": null
}

status, pending, confirmed veya declined değerlerinden biridir. confirmedVia, sahibi e-posta üzerinden onayladığında link, adres kendi gönderim için doğrulanmış alan adlarınızdan birindeyse ve onay gerekmediyse verified_domain, aksi halde null değerini alır. Bir rotanın yanıtı da aynı nesneyi forwardDestination altında taşır (aşağıdaki rota yanıtına bakın).

Bir Onayı Yeniden GöndermeBölüm bağlantısını kopyala

POST https://api.mail.land/v1/transactional/inbound/forward-destinations/{destinationId}/resend

Yalnızca hâlâ pending olan ve gerçekten bir bağlantıya ihtiyaç duyan bir hedef için (kendi doğrulanmış gönderim alan adlarınızdan birindeki bir adres, yeniden gönderilecek bir şey olmadığı için 409 FORWARD_DESTINATION_NO_CONFIRMATION_NEEDED döner). Hız sınırlıdır: hedef başına en fazla 5 dakikada bir ve günde 5 kez, tüm kiracı genelinde ise günde 50 kez. Her iki sınırın aşılması 429 FORWARD_CONFIRMATION_RATE_LIMITED döner.

Rota OluşturmaBölüm bağlantısını kopyala

Rotalar bir alan adına aittir ve bu alan adı altında oluşturulur.

POST https://api.mail.land/v1/transactional/inbound/domains/{domainId}/routes

{
  "name": "Support Inbox",
  "matchType": "exact",
  "matchPattern": "support",
  "actions": ["store", "webhook"],
  "webhookId": "w4k8m2q7p9x3z1",
  "priority": 10
}

curl -X POST https://api.mail.land/v1/transactional/inbound/domains/k3v9x2m8q1w7z4/routes \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Inbox",
    "matchType": "exact",
    "matchPattern": "support",
    "actions": ["store", "webhook"],
    "webhookId": "w4k8m2q7p9x3z1",
    "priority": 10
  }'

YanıtBölüm bağlantısını kopyala

{
  "id": "r7k3m9q2p4w8x1",
  "name": "Support Inbox",
  "domainId": "k3v9x2m8q1w7z4",
  "domainName": "yourdomain.com",
  "priority": 10,
  "isEnabled": true,
  "matchType": "Exact",
  "matchPattern": "support",
  "actions": ["store", "webhook"],
  "webhookId": "w4k8m2q7p9x3z1",
  "webhookName": "Support Webhook",
  "webhookUrl": "https://yourapp.com/webhooks/support",
  "forwardToEmail": null,
  "forwardDestination": null,
  "rejectStatus": null,
  "rejectMessage": null,
  "createdAt": "2026-02-17T12:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

İstekler matchType değerini herhangi bir büyük/küçük harfle kabul eder; yanıtlar her zaman enum adını büyük harfle başlayarak döndürür: Exact, Prefix, Suffix, Contains, PlusAddressing, CatchAll, Regex. Bir yanıtın matchType değerini küçük harfli bir dizeyle karşılaştırmayın.

forwardDestination, yalnızca actions içinde forward varsa doldurulur; Bir Yönlendirme Hedefini Getirme bölümünde açıklanan nesnenin aynısını taşır:

{
  "...": "...",
  "actions": ["store", "forward"],
  "forwardToEmail": "[email protected]",
  "forwardDestination": {
    "id": "f2k9m3q7p4w8x1",
    "email": "[email protected]",
    "status": "pending",
    "confirmedVia": null,
    "lastSentAt": "2026-09-26T10:00:00Z",
    "confirmedAt": null,
    "declinedAt": null
  }
}

Bir Alan Adının Rotalarını ListelemeBölüm bağlantısını kopyala

GET https://api.mail.land/v1/transactional/inbound/domains/{domainId}/routes

Alan adının tüm rotalarını, önceliğe göre (en düşük önce) sıralanmış olarak döndürür.

curl https://api.mail.land/v1/transactional/inbound/domains/k3v9x2m8q1w7z4/routes \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "items": [
    { "id": "r7k3m9q2p4w8x1", "name": "Support Inbox", "priority": 10, "isEnabled": true, "..." : "..." }
  ],
  "totalCount": 1
}

Tüm Rotaları ListelemeBölüm bağlantısını kopyala

Tenant'taki tüm alan adları genelinde rotaları listelemek için bunun yerine imleç sayfalamalı uç noktayı kullanın:

GET https://api.mail.land/v1/transactional/inbound/routes

Rota Ayrıntılarını AlmaBölüm bağlantısını kopyala

GET https://api.mail.land/v1/transactional/inbound/routes/{routeId}

curl https://api.mail.land/v1/transactional/inbound/routes/r7k3m9q2p4w8x1 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Rota GüncellemeBölüm bağlantısını kopyala

PUT https://api.mail.land/v1/transactional/inbound/routes/{routeId}

İstek gövdesi oluşturma isteğiyle aynıdır, ancak her alan isteğe bağlıdır, yalnızca gönderdiğiniz alanlar güncellenir.

curl -X PUT https://api.mail.land/v1/transactional/inbound/routes/r7k3m9q2p4w8x1 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "matchPattern": "help",
    "priority": 5
  }'

Rota Açma/KapamaBölüm bağlantısını kopyala

Başka bir alanı etkilemeden yalnızca isEnabled değerini tersine çevirir. İstek gövdesi yoktur.

POST https://api.mail.land/v1/transactional/inbound/routes/{routeId}/toggle

curl -X POST https://api.mail.land/v1/transactional/inbound/routes/r7k3m9q2p4w8x1/toggle \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Rotaları Yeniden SıralamaBölüm bağlantısını kopyala

Rota kimliklerini istenen sırada ileterek bir alan adındaki tüm rotaların önceliğini tek seferde güncelleyin: ilk kimlik öncelik 1 olur, ikincisi öncelik 2 olur ve böyle devam eder.

POST https://api.mail.land/v1/transactional/inbound/domains/{domainId}/routes/reorder

{
  "routeIds": ["r7k3m9q2p4w8x1", "m2p8w4x1k7q3z9", "x4k1p7m3q9w2z8"]
}

curl -X POST https://api.mail.land/v1/transactional/inbound/domains/k3v9x2m8q1w7z4/routes/reorder \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "routeIds": ["r7k3m9q2p4w8x1", "m2p8w4x1k7q3z9", "x4k1p7m3q9w2z8"]
  }'

Rota Test EtmeBölüm bağlantısını kopyala

Bir e-posta işlemeden, belirli bir alıcı adresiyle hangi rotanın eşleşeceğini kontrol edin.

POST https://api.mail.land/v1/transactional/inbound/domains/{domainId}/routes/test

{
  "emailAddress": "[email protected]"
}

curl -X POST https://api.mail.land/v1/transactional/inbound/domains/k3v9x2m8q1w7z4/routes/test \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "emailAddress": "[email protected]"
  }'

{
  "matched": true,
  "matchedRouteId": "r7k3m9q2p4w8x1",
  "matchedRouteName": "Support Inbox",
  "actions": ["store", "webhook"]
}

Hiçbir rota eşleşmezse yanıt 200 olur ve matched: false döner; matchedRouteId/matchedRouteName/actions hepsi null olur. 404, alan adının bulunamadığı veya test edilen adresin geçersiz olduğu (@ yok) anlamına gelir.

Rota SilmeBölüm bağlantısını kopyala

DELETE https://api.mail.land/v1/transactional/inbound/routes/{routeId}

curl -X DELETE https://api.mail.land/v1/transactional/inbound/routes/r7k3m9q2p4w8x1 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Örnek RotalarBölüm bağlantısını kopyala

Catch-all rota: eşleşmeyen tüm alıcıları depola:

{
  "name": "Catch All",
  "matchType": "catchall",
  "matchPattern": "*",
  "actions": ["store"],
  "priority": 999
}

Artı adresleme: tüm support+*@yourdomain.com varyantlarını bir webhook'a yönlendir:

{
  "name": "Support Tickets",
  "matchType": "plusaddressing",
  "matchPattern": "support",
  "actions": ["store", "webhook"],
  "webhookId": "w4k8m2q7p9x3z1",
  "priority": 5
}

SMTP'de reddetme: kabul edilmeden önce emekliye ayrılmış bir posta kutusuna gelen postayı reddet:

{
  "name": "Retired Mailbox",
  "matchType": "exact",
  "matchPattern": "old-team",
  "actions": ["reject"],
  "rejectStatus": "550 5.1.1",
  "rejectMessage": "Mailbox does not exist",
  "priority": 1
}

İletilen Bir Kopya Nasıl GörünürBölüm bağlantısını kopyala

İletilen bir kopya, orijinal baytların ham bir aktarımı değil, yeni ve sıradan bir transactional e-postadır: hedefin posta kutusu sağlayıcısında DKIM ve DMARC'ı geçebilmesi için doğrulanmış alan adınızdan gönderilir:

• From: "<orijinal gönderenin adı> via <eşleşen adres>@<alan adınız>", ör. "Jane Doe via [email protected]". Bir adrese benzeyen görünen ad (@, < veya > içeren) salt orijinal adresle değiştirilir, böylece bir kopya asla DKIM'iniz altında bir markayı taklit edemez.
• Reply-To: orijinal mesajın Reply-To alanı varsa o, yoksa orijinal gönderenin adresi; böylece yanıtlar size değil gerçek yazara ulaşır.
• İzleme yok: açılma ve tıklama izleme, çalışma alanınızın izleme ayarları ne olursa olsun, iletilen bir kopyada her zaman kapalıdır.
• Marka altbilgisi yok: diğer gönderimlerin taşıyabileceği Free plan altbilgisi asla eklenmez.
• Ekler: giden bir API gönderimiyle aynı kurallardan (tür, sayı, toplam boyut) geçirilir. Dışarıda bırakılan her şey kopyanın en üstünde bir notla belirtilir: "Forwarded without N attachment(s) that exceed the outbound attachment limits: ...", kopya yine de gelir, yalnızca bu parçalar olmadan.
• Etiket: her iletilen kopya inbound-forward etiketini taşır, böylece onları normal mesaj günlüğünüzde bulabilirsiniz; teslimat durumu (queued, sent, delivered, bounced vb.) diğer her transactional gönderimin aldığı durumla aynıdır, çünkü aynı teslimat hattından geçer.
• Kullanım: her iletilen kopya, planınızın kotasına ve faturalandırmasına karşı bir gönderim olarak sayılır ve API, SMTP, kampanya ve otomasyon gönderimlerinden ayrı olarak kullanım sayfasında kendi "Inbound forward" satırı olarak gösterilir.

Asla İletilmeyenlerBölüm bağlantısını kopyala

Bir forward rotasıyla eşleşen bir mesaj aşağıdaki durumlarda iletilmez ve asla faturalandırılmaz:

• Spam olarak işaretlendiyse veya gönderen spam olarak engellenmişse.
• Gönderen alan adının etkin politikasına göre DMARC'ı geçemediyse ve bu politika quarantine veya reject ise, gönderen alan adından yukarı çıkılarak uygulanabilir en yakın kayıt bulunur, böylece bir alt alan adının kendi sp= değeri, kurumsal alan adının p= değerine üstün gelir ve t=y (test) veya pct=0 kaydı bir politika seviyesi daha düşük sayılır, iletmek, gönderenin alıcılardan açıkça reddetmesini istediği bir mesajı yeniden imzalamak anlamına gelir.
• Kendisi veya HTML/metin gövdesi, platformun giden boyut sınırlarının üzerindeyse.
• İletmek bir döngü yaratacaksa: hedef, mesajın kendi alıcılarından biriyse veya zaten çok fazla atlama ya da Received başlığı taşıyorsa.

Uygun olan ama geçici olarak gönderilemeyen bir kopya (bir politika gecikmesi, bir kota penceresi, bir kesinti) geri çekilerek en fazla 24 saat yeniden denenir, ardından gönderilmeden süresi dolar. Bir mesaj alındıktan sonra devre dışı bırakılan, silinen veya hedefi değiştirilen bir rota da hâlâ bekleyen her kopyayı durdurur: mevcut rota yapılandırması her zaman geçerlidir.

Bir İletmenin Sonucunu Kontrol EtmeBölüm bağlantısını kopyala

forward rotasıyla eşleşen her gelen e-posta, ayrıntı yanıtında (GET /v1/transactional/inbound/emails/{id}) bir forwards dizisi taşır: mesajın iletilmek üzere kuyruğa alındığı her hedef için bir kayıt, böylece yalnızca yapılandırılan hedefi değil, gerçekte ne olduğunu görebilirsiniz.

"forwards": [
  {
    "destination": "[email protected]",
    "status": "Admitted",
    "reason": null,
    "omittedAttachmentCount": 0,
    "messageId": "m_01hz3k...",
    "createdAt": "2026-09-26T10:00:00Z",
    "updatedAt": "2026-09-26T10:00:02Z"
  }
]

status şunlardan biridir:

Pending, Processing ve Deferred tek kalıcı olmayan durumlardır, diğer her değer kalıcıdır.

Yönlendirme Hata YanıtlarıBölüm bağlantısını kopyala

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

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

• Inbound Overview: gelen e-posta işlemenin nasıl çalıştığı
• Inbound Webhooks: webhook yükü biçimi ve teslimatı
• Domains: gelen posta için MX kayıtlarını yapılandırma