Geçiş kılavuzu

Arkose FunCAPTCHA'dan CaptchaLa'ya Geçiş

SDK ağırlığından kurtulun, kurumsal sözleşmeyi bitirin, uyarlanabilir bot savunmasını koruyun. Geçiş, tek script değişimi ve tek doğrulama uç noktası değişikliğidir.

AArkose / FunCAPTCHACurrent setup~10 minCaptchaLaDrop-in target

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

Önce — Arkose / FunCAPTCHA
<script src="https://YOUR_PUBLIC_KEY.arkoselabs.com/v2/YOUR_PUBLIC_KEY/api.js" data-callback="onSuccess" async defer></script>
<script>
  function onSuccess(token) {
    document.getElementById('arkose-token').value = token
  }
</script>
<input type="hidden" id="arkose-token" name="arkose-token" />
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 — Arkose sunucu doğrulaması (Node)
const res = await fetch('https://verify-api.arkoselabs.com/api/v4/verify/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    private_key: process.env.ARKOSE_PRIVATE_KEY,
    session_token: req.body['arkose-token'],
  }),
})
const data = await res.json()
if (data.session_details?.solved !== true) 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. Arkose'un aksine, PoC ve satın alma süreci yoktur — fiyatlandırma açıktır ve self-servistir. Ücretsiz katman başlangıç testlerini kapsar.

  2. 2

    Arkose SDK'sını ve geri çağırma bağlantısını kaldırın

    Arkose script etiketini, geri çağırma işlevini ve geri çağırmadan doldurduğunuz gizli girişi silin. CaptchaLa basit bir div yer tutucusu kullanır — geri çağırma bağlantısı yoktur.

  3. 3

    CaptchaLa widget'ını ekleyin

    Arkose widget'ının olduğu yere div ve script etiketimizi yerleştirin. Gizli token alanı captchala-token olarak otomatik doldurulur; manuel yönetmezsiniz.

  4. 4

    Sunucu doğrulamasını güncelleyin

    Arkose'un session_details.solved kontrolünü bizim valid bayrağımızla (data.valid) değiştirin. Uç nokta apiv1.captcha.la/v1/validate olarak değişir. Gövde form-urlencoded yerine JSON olur.

  5. 5

    Sözleşme sonlandırmasını planlayın

    Arkose sözleşmeleri genellikle yıllıktır ve otomatik yenilemelidir. Sözleşmenizdeki iptal penceresine dikkat edin ve hukuk/satın alma birimine bildirimde bulunun. Çoğu ekip, sonlandırma sırasında 30 gün boyunca ikisini paralel çalıştırır.

Sıkça sorulan sorular

Geçiş yaparak bot algılama doğruluğunu kaybeder miyim?

Çoğu iş yükü için ölçülebilir bir fark yok. Arkose'un doğrulamaları varsayılan olarak bizimkilerden kasıtlı olarak daha zordur, ancak yakaladıkları bot popülasyonu ile bizim yakaladığımız popülasyon tipik ürün trafiği için büyük ölçüde örtüşür. Roblox / Microsoft ölçeğinde, adı belirli rakiplere sahipseniz cevap daha incelikli olur — önce bizimle konuşun.

Sözleşme örtüşmesini nasıl yönetirim?

Sonlandırma sırasında ikisini yan yana çalıştırın. Form A Arkose'u tutar; Form B CaptchaLa'ya geçer. Dönüşüm + bot oranını karşılaştırın. Çoğu ekip bot oranının sabit kaldığını ve kullanıcı sürtünmesi oranının düştüğünü görür. Ardından sözleşme yenilemesinde Arkose'u devre dışı bırakın.

Arkose'un risk telemetrisi / analitik panoları ne olacak?

CaptchaLa'nın karşılaştırılabilir telemetriye sahip kendi panosu vardır — doğrulama oranı, başarı oranı, risk puanı dağılımı, coğrafi dökümü. Arkose Insights'tan geliyorsanız yapı tanıdık gelecektir.