Panduan migrasi

Migrasi dari Arkose FunCAPTCHA ke CaptchaLa

Lepaskan bobot SDK, akhiri kontrak enterprise, pertahankan pertahanan bot adaptif. Migrasinya hanya satu pertukaran script dan satu perubahan endpoint verifikasi.

AArkose / FunCAPTCHACurrent setup~10 minCaptchaLaDrop-in target

Seperti apa perubahan kodenya

Before — 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" />
After — 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>
Before — Arkose server verify (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' })
After — CaptchaLa server verify (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' })

Langkah migrasi

  1. 1

    Daftar & ambil App Key + Secret Anda

    Buat akun CaptchaLa gratis. Tidak seperti Arkose, tidak ada PoC dan tidak ada proses pengadaan — harga dipublikasikan dan mandiri. Paket gratis mencakup pengujian awal.

  2. 2

    Hapus SDK Arkose & wiring callback

    Hapus tag script Arkose, fungsi callback, dan input tersembunyi yang Anda isi dari callback. CaptchaLa memakai placeholder div sederhana — tanpa wiring callback.

  3. 3

    Tambahkan widget CaptchaLa

    Letakkan div dan tag script kami di tempat widget Arkose berada. Field token tersembunyi terisi otomatis sebagai captchala-token; Anda tidak perlu mengelolanya secara manual.

  4. 4

    Perbarui verifikasi server

    Ganti pemeriksaan session_details.solved milik Arkose dengan flag valid kami (data.valid). Endpoint berubah menjadi apiv1.captcha.la/v1/validate. Body menjadi JSON, bukan form-urlencoded.

  5. 5

    Rencanakan penghentian kontrak

    Kontrak Arkose biasanya tahunan dengan perpanjangan otomatis. Catat jendela pembatalan di kontrak Anda dan beri tahu legal/pengadaan. Kebanyakan tim menjalankan keduanya secara paralel selama 30 hari saat penghentian.

Pertanyaan umum

Apakah saya akan kehilangan akurasi deteksi bot dengan beralih?

Untuk sebagian besar beban kerja, tidak ada perbedaan terukur. Challenge Arkose memang sengaja lebih sulit daripada kami secara default, tetapi populasi bot yang mereka tangkap dan yang kami tangkap sangat tumpang tindih untuk lalu lintas produk pada umumnya. Jika Anda berada di skala Roblox / Microsoft dengan adversari bernama, jawabannya lebih bernuansa — bicaralah dengan kami dulu.

Bagaimana cara menangani tumpang tindih kontrak?

Jalankan keduanya berdampingan selama penghentian. Formulir A tetap Arkose; Formulir B beralih ke CaptchaLa. Bandingkan konversi + tingkat bot. Kebanyakan tim mendapati tingkat bot tetap stabil dan tingkat friksi pengguna turun. Lalu hentikan Arkose saat perpanjangan kontrak.

Bagaimana dengan telemetri risiko / dashboard analitik Arkose?

CaptchaLa punya dashboard sendiri dengan telemetri yang sebanding — tingkat challenge, tingkat keberhasilan, distribusi skor risiko, rincian geo. Bentuknya akan terasa familier jika Anda datang dari Arkose Insights.