Hướng dẫn chuyển đổi

Chuyển từ Arkose FunCAPTCHA sang CaptchaLa

Bỏ đi trọng lượng SDK, kết thúc hợp đồng enterprise, giữ phòng thủ bot thích ứng. Việc chuyển đổi chỉ là đổi một script và một endpoint xác thực.

AArkose / FunCAPTCHACurrent setup~10 minCaptchaLaDrop-in target

Thay đổi mã trông như thế nào

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' })

Các bước chuyển đổi

  1. 1

    Đăng ký & lấy App Key + Secret

    Tạo tài khoản CaptchaLa miễn phí. Khác với Arkose, không có PoC và không có quy trình mua sắm — giá được công bố và tự phục vụ. Gói miễn phí đủ cho thử nghiệm ban đầu.

  2. 2

    Gỡ SDK Arkose & phần đấu nối callback

    Xóa thẻ script Arkose, hàm callback, và input ẩn mà bạn điền từ callback. CaptchaLa dùng một div placeholder đơn giản — không cần đấu nối callback.

  3. 3

    Thêm widget CaptchaLa

    Đặt div và thẻ script của chúng tôi vào nơi widget Arkose từng ở. Trường token ẩn được tự động điền dưới dạng captchala-token; bạn không phải quản lý thủ công.

  4. 4

    Cập nhật xác thực máy chủ

    Thay phần kiểm tra session_details.solved của Arkose bằng cờ valid của chúng tôi (data.valid). Endpoint đổi thành apiv1.captcha.la/v1/validate. Body chuyển sang JSON thay vì form-urlencoded.

  5. 5

    Lên kế hoạch kết thúc hợp đồng

    Hợp đồng Arkose thường theo năm và tự gia hạn. Hãy ghi nhớ thời hạn hủy trong hợp đồng và thông báo cho bộ phận pháp lý/mua sắm. Phần lớn các đội chạy song song cả hai trong 30 ngày trong giai đoạn kết thúc.

Câu hỏi thường gặp

Chuyển đổi có làm tôi mất độ chính xác phát hiện bot không?

Với hầu hết khối lượng công việc, không có khác biệt đáng kể nào đo được. Thử thách của Arkose mặc định khó hơn của chúng tôi một cách có chủ đích, nhưng tập bot họ chặn và tập bot chúng tôi chặn trùng lặp rất nhiều với lưu lượng sản phẩm thông thường. Nếu bạn ở quy mô Roblox / Microsoft với đối thủ có tên tuổi, câu trả lời sẽ tinh tế hơn — hãy trao đổi với chúng tôi trước.

Tôi xử lý giai đoạn chồng hợp đồng thế nào?

Chạy song song trong giai đoạn kết thúc. Biểu mẫu A giữ Arkose; Biểu mẫu B chuyển sang CaptchaLa. So sánh tỷ lệ chuyển đổi + tỷ lệ bot. Phần lớn các đội thấy tỷ lệ bot giữ nguyên còn tỷ lệ ma sát người dùng giảm. Sau đó ngừng Arkose khi đến kỳ gia hạn hợp đồng.

Còn dữ liệu rủi ro / bảng phân tích của Arkose thì sao?

CaptchaLa có bảng điều khiển riêng với dữ liệu tương đương — tỷ lệ thử thách, tỷ lệ thành công, phân bố điểm rủi ro, phân tách theo địa lý. Hình thức quen thuộc nếu bạn đến từ Arkose Insights.