Geçiş kılavuzu

reCAPTCHA'dan CaptchaLa'ya Geçiş

10 dakikadan kısa sürede doğrudan takılan bir alternatif. Formlarınızı koruyun, yalnızca doğrulama sağlayıcısını değiştirin. Vanilla HTML, WordPress, Flarum ve her türlü arka uçla çalışır.

GreCAPTCHACurrent setup~10 minCaptchaLaDrop-in target

Kod değişikliği nasıl görünür

Önce — reCAPTCHA v2
<div class="g-recaptcha" data-sitekey="YOUR_SITE_KEY"></div>
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
Sonra — CaptchaLa
<button id="login-btn">Sign in</button>
<script src="https://cdn.captcha-cdn.net/captchala-loader.js"></script>
<script>
  loadCaptchala(() => Captchala.init({ appKey: 'YOUR_APP_KEY', action: 'login' })
    .onSuccess(res => onToken(res.token))
    .bindTo('#login-btn'));
</script>
Önce — reCAPTCHA sunucu doğrulaması (Node)
const res = await fetch('https://www.google.com/recaptcha/api/siteverify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    secret: process.env.RECAPTCHA_SECRET,
    response: req.body['g-recaptcha-response'],
  }),
})
const data = await res.json()
if (!data.success) return res.status(400).json({ error: 'bot' })
Sonra — CaptchaLa sunucu doğrulaması (Node)
const res = await fetch('https://apiv1.captcha.la/v1/validate', {
  method: 'POST',
  headers: {
    'X-App-Key': process.env.CAPTCHALA_APP_KEY,
    'X-App-Secret': process.env.CAPTCHALA_APP_SECRET,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ pass_token: req.body['captchala-token'] }),
})
const { data } = await res.json()
if (!data || !data.valid) return res.status(400).json({ error: 'bot' })

Geçiş adımları

  1. 1

    Kaydolun ve App Key + Secret'inizi alın

    Ücretsiz bir CaptchaLa hesabı oluşturun, bir site ekleyin ve App Key'i (genel) ile App Secret'i (sunucu tarafı) kopyalayın. Kart gerekmez.

  2. 2

    Formunuzdaki widget etiketini değiştirin

    reCAPTCHA div'ini ve script src'sini CaptchaLa karşılıklarıyla değiştirin. Etiket sınıfı g-recaptcha'dan captchala'ya, data-sitekey data-app-key'e dönüşür ve script URL'si bizim CDN'imizi gösterir.

  3. 3

    Form gönderim alanı adını güncelleyin

    reCAPTCHA, g-recaptcha-response adında gizli bir alan ekler. CaptchaLa captchala-token kullanır. Form işleyiciniz alanı adıyla okuyorsa sabiti yeniden adlandırın; aksi halde gizli giriş otomatik olarak akar.

  4. 4

    Sunucu tarafı doğrulamayı güncelleyin

    Doğrulama isteğini, başlıklarda uygulama kimlik bilgileri (X-App-Key / X-App-Secret) ve JSON gövdesinde pass_token ile apiv1.captcha.la/v1/validate adresine yönlendirin. Yanıt yapısı reCAPTCHA ile aynı valid bayrağını (data.valid) döndürür, böylece mevcut dallanma kodunuz olduğu gibi kalır.

  5. 5

    Kademeli olarak yayına alın

    Çoğu ekip önce tek bir forma (genelde en az trafiği olan — bülten kaydı veya iletişim) geçer, birkaç saat dönüşüm ve doğrulama oranını izler, ardından genişletir. Minimum tutar veya sözleşme olmadığından kademeli geçiş ücretsizdir.

Sıkça sorulan sorular

Tüm formları aynı anda taşımam gerekiyor mu?

Hayır. İki sistem aynı sitede bir arada bulunur — durum veya çerez paylaşmazlar. Formları teker teker taşıyın.

reCAPTCHA Enterprise'ın risk puanları ne olacak? Puanlar aktarılır mı?

Puanlar aktarılmaz (sağlayıcıya özeldir), ancak CaptchaLa doğrulama yanıtında kendi risk puanını döndürür. Sayısal aralık ve karar mantığı belgelenmiştir; ekipler genellikle mevcut puan eşiklerini (ör. 0,5) bizimkine bir saat içinde eşler.

Google Site Doğrulamam veya diğer Google entegrasyonlarım bozulur mu?

Hayır. reCAPTCHA, Search Console / Site Doğrulama / Analytics'ten ayrıdır. reCAPTCHA etiketini kaldırmanın başka hiçbir Google hizmetine etkisi yoktur.

Çok sayıda gömülü reCAPTCHA etiketi olan siteler için bir geçiş betiği var mı?

Bir tane sunmuyoruz (bul-değiştir her depo için tek bir regex'tir ve her kod tabanının şablonlama yapısı farklıdır). Çoğu ekibin kullandığı 10 satırlık kabuk parçacığı dokümanlardadır.