Form Inbox — entegrasyon rehberi

Uç nokta

Genel gönderimler: POST /api/tools/forms/YOUR_FORM_KEY — YOUR_FORM_KEY panoda oluşturulur; burada yalnızca yer tutucu gösterilir. İstek gövdesi boyutu sunucuda üst sınıra tabidir (çok büyük gövde 413 dönebilir).

Kurulum: klasik HTML formu

YOUR_DOMAIN kendi kök alan adınız (ör. shortmoxagency.com.tr) ile değiştirin. Origin / Referer allowlist ile uyumlu olmalıdır — aksi halde 403 alırsınız.

<form action="https://YOUR_DOMAIN/api/tools/forms/YOUR_FORM_KEY" method="POST">
  <input name="name" type="text" placeholder="Ad" />
  <input name="email" type="email" placeholder="E-posta" />
  <input name="subject" type="text" placeholder="Konu" />
  <textarea name="message" placeholder="Mesaj" required></textarea>
  <!-- Honeypot: CSS ile gizleyin; bot doldurursa gönderim sessizce reddedilir -->
  <input type="text" name="_gotcha" style="display:none" tabindex="-1" autocomplete="off" />
  <button type="submit">Gönder</button>
</form>

Kurulum: JSON (fetch)

Accept: application/json veya Content-Type: application/json ile yanıt JSON olabilir. message alanı zorunludur; e-posta formatı doğrulanır.

const response = await fetch("https://YOUR_DOMAIN/api/tools/forms/YOUR_FORM_KEY", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "accept": "application/json",
  },
  body: JSON.stringify({
    name: "Ada",
    email: "ada@example.com",
    subject: "Merhaba",
    message: "Kısa mesaj metni",
  }),
});
const data = await response.json();

Dikkat ve limitler

• Honeypot alanı _gotcha doldurulursa gönderim sessizce kabul edilir (bot tuzağı).
• Çok sık isteklerde HTTP 429 dönebilir — exponential backoff kullanın.
• İsteğe bağlı redirect alanı yalnızca http/https hedefleri için yönlendirme üretir.
• Ek yükleme ve giden otomatik yanıt postası MVP’de kapalı veya kısıtlı olabilir.

Pano ve güvenlik

Gönderim listesi ve CSV dışa aktarma yalnızca yetkili oturumla yönetici panosunda — oturum yoksa giriş sayfasına yönlendirilirsiniz. Kötüye kullanım raporlaması ve hukuki süreçler sizin operasyonunuzdur.