Log perubahan

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

API

2026-06-20

• Respons /v1/validate kini mengembalikan objek captcha_args — konteks pada masa penyelesaian yang dipulangkan semula untuk pengelogan / penskoran risiko anda sendiri (tidak pernah diperlukan untuk lulus/gagal):
  • platform — web / android / ios / flutter / windows / …
  • user_ip — IP pengguna akhir yang direkodkan pada masa penyelesaian
  • referer — URL halaman penyelesaian (web); null pada platform natif
  • pkg — id pakej / bundle aplikasi (natif); null pada web
  • solved_at — masa penyelesaian selesai (saat unix)
  • risk_score — skor risiko pada masa penyelesaian (0-100, lebih tinggi = lebih berisiko)
• client_ip pada /v1/validate adalah pilihan tetapi disyorkan — IP pengguna akhir daripada permintaan masuk anda, digunakan untuk pemeriksaan risiko tambahan. Selamat untuk ditinggalkan. (Padanan tepat IP penyelesaian lawan penghantaran telah digugurkan kerana ia menolak pengguna sah pada rangkaian CDN + dwitindanan IPv4/IPv6.)
• Serasi sepenuhnya ke belakang — penyepaduan sedia ada terus berfungsi tanpa perubahan.

PHP SDK (captchala/captchala-php)

1.2.3 — 2026-06-20

• Menambah ValidateResult::getUserIp() dan ValidateResult::getCaptchaArgs().
• $clientIp pada validate() kini pilihan tetapi disyorkan (digunakan untuk pemeriksaan risiko). Serasi ke belakang.

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

1.2.2 — 2026-06-20

• Menambah ValidateResult.CaptchaArgs (struct CaptchaArgs: Platform, UserIP, Referer, Pkg, SolvedAt, RiskScore).
• Argumen IP pada ValidateWithClientIP kini pilihan tetapi disyorkan. Serasi ke belakang.