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.comalt 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ınname değerleri oluşturucudaki Alan kimliği ile eşleşmelidir. Aşağıdaki örnek name, email ve message kimliklerini kullanan İletişim şablonuna göredir; kendi formunuz için Paylaş sekmesindeki dinamik örneği alın. Yalnızca yayımlanmış ve koşula göre görünür alanları gönderin.
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:
error ve kullanıcıya gösterilebilecek message içerir; doğrulama hatalarında fieldErrors, hız sınırında retryAfter eklenebilir:
Dinamik türleri ve dosyaları gönderin
Çoklu seçim alanlarını seçenek değerlerinden oluşan dizi, onay kutusunu"1", sayıları ondalık noktayla ve tarihleri YYYY-AA-GG biçiminde gönderin. Telefon alanında ülke kodu için <alan_kimliği>_cc kullanılabilir. Seçenek etiketi yerine kalıcı seçeneğin value değerini kullanın. Koşul nedeniyle gizlenen alanlar doğrulanmaz ve kaydedilmez.
IletisimForm.attach dosya alanlarındaki File / FileList değerlerini önce yükler; gönderime dönen dosya belirteçlerini ekler. Özel akışta IletisimForm.upload kullanılabilir; parametreleri için panelin Paylaş örneğini esas alın. Dosya başına en çok 10 MB, alan başına en çok 5 dosya ve form alanındaki kabul edilen tür kuralı geçerlidir.
Çok adımlı kendi formunuzda görünürlük ve adım doğrulamasını uygulayın. Paylaş → Yapay zekâ ile oluştur istemi yayımlanmış alanları, seçenekleri, koşulları, adımları, dosya ve gizli alanları birlikte içerir. Alan değişikliklerinden sonra formu yeniden yayınlayıp istemi ve entegrasyon kodunu güncelleyin.
HTTP durumlarını işleyin
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, gönderim için 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. Geçerli gönderimler her zaman Yeni olarak kaydedilir. Gizli tuzak alanı veya hızlı doldurma Şüpheli işaret bilgisi oluşturabilir; otomatik Spam yapılmaz, kişi/süreç/bildirim akışı durdurulmaz. API yolunda doldurma süresi ölçülmez. Spam durumu panelde elle verilir. 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: 24 Ekim 2026.