更新日誌

CaptchaLa API 與 SDK 的重要變更。日期皆為 UTC。

API

2026-06-20

• /v1/validate 回應現在會回傳一個 captcha_args 物件，將解題時的情境資訊回傳給你，供記錄日誌或進行自訂風險評分使用（通過／不通過的判定永遠不需要它）：
  • platform — web / android / ios / flutter / windows / …
  • user_ip — 解題時記錄的終端使用者 IP
  • referer — 解題頁面網址（web）；原生平台為 null
  • pkg — 應用程式套件／bundle id（原生）；web 為 null
  • solved_at — 解題完成時間（unix 秒）
  • risk_score — 解題時的風險分數（0-100，越高越危險）
• /v1/validate 上的 client_ip 為選填但建議提供 — 來自你後端請求中的終端使用者 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 參數現在為選填但建議提供。向後相容。