Catatan perubahan

Perubahan penting pada API dan SDK CaptchaLa. Tanggal dalam UTC.

API

2026-06-20

• Respons /v1/validate kini mengembalikan objek captcha_args — konteks pada saat penyelesaian yang dipantulkan kembali untuk pencatatan / penilaian risiko Anda sendiri (tidak pernah diperlukan untuk lulus/gagal):
  • platform — web / android / ios / flutter / windows / …
  • user_ip — IP pengguna akhir yang dicatat pada saat penyelesaian
  • referer — URL halaman penyelesaian (web); null pada platform native
  • pkg — id paket / bundle aplikasi (native); null pada web
  • solved_at — waktu penyelesaian selesai (detik unix)
  • risk_score — skor risiko pada saat penyelesaian (0-100, lebih tinggi = lebih berisiko)
• client_ip pada /v1/validate bersifat opsional tetapi disarankan — IP pengguna akhir dari permintaan masuk Anda, digunakan untuk pemeriksaan risiko tambahan. Aman untuk dihilangkan. (Pencocokan IP yang tepat antara penyelesaian dan pengiriman dihapus karena menolak pengguna sah pada jaringan CDN + dual-stack IPv4/IPv6.)
• Sepenuhnya kompatibel ke belakang — integrasi yang ada tetap berfungsi tanpa perubahan.

PHP SDK (captchala/captchala-php)

1.2.3 — 2026-06-20

• Menambahkan ValidateResult::getUserIp() dan ValidateResult::getCaptchaArgs().
• $clientIp pada validate() kini opsional tetapi disarankan (digunakan untuk pemeriksaan risiko). Kompatibel ke belakang.

Go SDK (github.com/Captcha-La/captchala-go)

1.2.2 — 2026-06-20

• Menambahkan ValidateResult.CaptchaArgs (struct CaptchaArgs: Platform, UserIP, Referer, Pkg, SolvedAt, RiskScore).
• Argumen IP pada ValidateWithClientIP kini opsional tetapi disarankan. Kompatibel ke belakang.