Kendi formunuzla gönderim

Formu API gönderimine açın

Bu yöntem, ziyaretçinin doğrudan tarayıcısından gönderim yapan özel HTML formları içindir. Formları listelemek veya gönderimleri panel dışından yönetmek için kullanılan API anahtarına bağlı değildir.

Panelde Formlar → Formlar görünümünden formu açın.
Davranış → İzinli alan adları bölümüne formun çalışacağı alan adını ekleyin. *.ornek.com alt alan adlarını kapsar.
API ile gönderime izin ver’i açın.
Yayınla veya Değişiklikleri yayınla’yı seçin. Davranış ayarları yayınlanana kadar dışarıda değişmez.
Paylaş → Kendi formunuzdan gönderim (API) bölümündeki formunuza özel örneği kopyalayın.

client.js ile bağlayın

HTML alanlarının name değerleri yayımladığınız alan anahtarlarıyla eşleşmelidir: name, phone, email, company, subject ve message. Yalnızca formda açık olanları gönderin.

<form id="iletisim-form">
  <label>
    Ad soyad
    <input name="name" autocomplete="name" required>
  </label>
  <label>
    E-posta
    <input name="email" type="email" autocomplete="email">
  </label>
  <label>
    Mesaj
    <textarea name="message" required></textarea>
  </label>
  <button type="submit">Gönder</button>
  <p id="iletisim-sonuc" role="status"></p>
</form>

<script src="https://forms.iletisim.app/client.js"></script>
<script>
  IletisimForm.attach(document.getElementById("iletisim-form"), {
    key: "FORM_ANAHTARI",
    onResult: function (result) {
      document.getElementById("iletisim-sonuc").textContent = result.message;
      if (result.ok && result.redirectUrl) location.href = result.redirectUrl;
    },
  });
</script>

attach, formun submit olayını yönetir; gönder düğmesini işlem sırasında kapatır ve alan bazlı hataları data-iletisim-error="alan" taşıyan öğelere yazabilir. Daha özel bir akışta doğrudan gönderin:

const result = await IletisimForm.submit("FORM_ANAHTARI", {
  name: "Ayşe Yılmaz",
  email: "ayse@ornek.com",
  message: "Randevu saatleri hakkında bilgi almak istiyorum.",
});

Başarılı yanıtın biçimi:

{ "ok": true, "id": "…", "message": "Teşekkür ederiz.", "redirectUrl": null }

Hata yanıtı error ve kullanıcıya gösterilebilecek message içerir; doğrulama hatalarında fieldErrors, hız sınırında retryAfter eklenebilir:

{
  "ok": false,
  "error": "invalid_fields",
  "message": "Lütfen işaretli alanları düzeltin.",
  "fieldErrors": { "email": "invalid_email" }
}

HTTP durumlarını işleyin

Durum	Anlamı ve yapılacak işlem
`400`	Meydan okuma, istek gövdesi veya Turnstile doğrulaması geçersiz. `client.js` kullanın; süresi dolan meydan okumayı betik bir kez kendiliğinden yeniler.
`403`	API kapalı (`api_disabled`) veya gönderen köken izinli değil (`origin_not_allowed`). Davranış ayarlarını düzeltip yeniden yayınlayın.
`404`	Form anahtarı bulunamadı ya da form hiç yayımlanmadı (`not_found`).
`410`	Form arşivlenmiş ve gönderim kabul etmiyor (`form_archived`).
`413`	İstek gövdesi 64 KB sınırını aşıyor (`too_large`).
`422`	Alanlar eksik veya yayımlanmış form kurallarına uymuyor (`invalid_fields`). `fieldErrors` değerlerini alanların yanında gösterin.
`429`	Hız sınırı aşıldı (`rate_limited`). `retryAfter` veya `Retry-After` kadar bekleyin.
`503`	Gönderim geçici olarak kullanılamıyor (`unavailable`). Kullanıcıya daha sonra yeniden denemesini söyleyin.

client.js aynı gönderimin ağ nedeniyle tekrar edilmesinde tek kullanımlık meydan okuma kimliğini tekrar anahtarı olarak kullanır; başarılı kayıt ikinci kez oluşturulmaz.

Güvenlik modelini anlayın

client.js, form açılırken imzalı ve kısa ömürlü bir meydan okuma alır; SHA-256 tabanlı iş kanıtını ziyaretçinin tarayıcısında çözer. Meydan okuma tek kullanımlıdır ve gönderim yalnızca izinli Origin değerinden kabul edilir. Düz curl isteği meydan okuma taşımadığı için 400 invalid_challenge ile reddedilir. Gönderimler form ve IP başına hız sınırından geçer. Görünmeyen tuzak alanı dolu veya form olağan dışı hızlı gönderilmişse kayıt Spam karantinasına alınır; kişi, süreç ve bildirim oluşturulmaz. Bu kontrolleri kendi kodunuzda yeniden üretmeniz gerekmez. İsterseniz Davranış → Kendi Turnstile anahtarınız bölümüne Cloudflare Turnstile site ve gizli anahtarlarınızı ekleyebilirsiniz. Bu durumda kendi sayfanızdaki Turnstile bileşeninin cf-turnstile-response değerini gönderin. Gizli anahtar yalnızca sunucuda saklanır ve kaydedildikten sonra panelde yeniden gösterilmez. Formu hazır İletişim görünümüyle eklemek için Formu sitenize ekleme sayfasına bakın. Son güncelleme: 23 Ekim 2026.

Bağlantı

Formlar

Başvuru

Kendi formunuzla gönderim

Formu API gönderimine açın

client.js ile bağlayın

HTTP durumlarını işleyin

Güvenlik modelini anlayın

​Formu API gönderimine açın

​client.js ile bağlayın

​HTTP durumlarını işleyin

​Güvenlik modelini anlayın

Formu API gönderimine açın

client.js ile bağlayın

HTTP durumlarını işleyin

Güvenlik modelini anlayın