Shortmox Tools · entegrasyon rehberi

Mail Sandbox — entegrasyon özeti

Geliştirici test gelen kutusu: staging doğrulama ve şablon kontrolleri için gelen mesajı güvenli şekilde okuyun. Geçici/fake mail veya gerçek kullanıcı doğrulamasını atlatan araç değildir. Giden posta yok; ek yükleme ve iletme yok; üretim MX teslimatının yerine geçmez.

Bu rehber hukuki veya denetim danışmanlığı değildir. Üretim anahtarlarınızı depolamayın; örneklerde YOUR_* yer tutucuları kullanın. Admin panoları ve çoğu yazma API’si oturum gerektirir — ayrıntılar erişim politikası.

Mail Sandbox ürün sayfası Pro / Agency iletişim

Sınırlar (kodla uyumlu)

Quick inbox TTL ~15 dk; Developer ~30 gün.
PostgreSQL yolunda gelen kutusu başına en fazla 250 mesaj; inbox süresi sonrası mesajlar için ~24 saat ek pencere.
Test inbound: JSON ~80000 bayt; ~40 istek / 60s (IP özeti).

Test inbound API

Aşağıdaki uç, kontrollü JSON ile test mesajı yüklemek içindir. Multipart veya dosya eki kabul edilmez; aşımda 413 veya 429 dönebilir.

// POST /api/tools/mail-sandbox/inbound/test
// Content-Type: application/json
// YOUR_INBOX_KEY panodan — örnek yer tutucu
await fetch("https://YOUR_DOMAIN/api/tools/mail-sandbox/inbound/test", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    inboxKey: "YOUR_INBOX_KEY",
    from: "sender@example.com",
    subject: "Sandbox test",
    textBody: "Merhaba — üretim sırları veya ek tabanlı içerik göndermeyin.",
  }),
});

htmlBody alternatif olarak kullanılabilir; en az biri (textBody veya htmlBody) gerekir — ayrıntılar API yanıt mesajlarında doğrulanır.

Kötüye kullanım ve güvenlik

Bu ucu geçici hesap oluşturmak veya üçüncü kişilere posta yönlendirmek için kullanmayın.
Kişisel veya müşteri verisini izinsiz test etmeyin.
IP özetleri kötüye kullanım önlemi için kullanılabilir; kayıt politikası sürüme bağlıdır.

Pano

Gelen kutusu oluşturma ve mesaj okuma admin panosunda; oturum olmadan erişilemez.

Sık sorulanlar

Üretim posta kutusu veya MX teslimatı yerine geçer mi?

Hayır — kontrollü test ve inceleme içindir. Bu sürümde giden posta (SMTP) yoktur; SLA veya teslimat garantisi yoktur.

YOUR_INBOX_KEY nedir?

Panoda oluşturulan gelen kutusu anahtarıdır; örneklerde yer tutucu kullanın.

Genel kullanıma açık geçici e-posta servisi mi?

Hayır — ajans ve geliştirici ekiplerinin güvenli test mesajlarını merkezileştirmesi içindir; anonim kayıt veya üçüncü kişilere yönlendirme amaçlı kullanılmamalıdır.

Hangi uç test mesajı kabul eder?

Aşağıdaki JSON örneği `/api/tools/mail-sandbox/inbound/test` uç noktasını gösterir; üretim SMTP köprüsü değildir.