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.
Kod değişikliği nasıl görünür
<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" /><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>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' })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
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
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
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
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
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.