更新日志

CaptchaLa API 与 SDK 的重要变更。日期为 UTC。

API

2026-06-20

• /v1/validate 响应新增 captcha_args 对象 —— 回显解题当时的上下文,供日志 / 你自己的二次风控(不参与 pass/fail):
  • platform —— web / android / ios / flutter / windows / …
  • user_ip —— 解题时记录的终端用户 IP
  • referer —— 解题页面 URL(web);native 为 null
  • pkg —— app 包名 / bundle id(native);web 为 null
  • solved_at —— 解题完成时间(unix 秒)
  • risk_score —— 解题时风险分(0-100,越高越可疑)
• client_ip(/v1/validate)可选,建议传 —— 从你的入站请求里取到的终端 用户 IP,用于额外的风控校验;不传也可以。(精确 IP 比对已取消 —— 在 CDN + 双栈 IPv4/IPv6 下会误拒合法用户。)
• 完全向后兼容,现有对接无需改动。

PHP SDK(captchala/captchala-php)

1.2.3 — 2026-06-20

• 新增 ValidateResult::getUserIp() 和 ValidateResult::getCaptchaArgs()。
• validate() 的 $clientIp 改为可选、建议传(用于风控)。向后兼容。

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

1.2.2 — 2026-06-20

• 新增 ValidateResult.CaptchaArgs(CaptchaArgs 结构:Platform、UserIP、 Referer、Pkg、SolvedAt、RiskScore)。
• ValidateWithClientIP 的 IP 参数改为可选、建议传。向后兼容。