変更履歴

CaptchaLa API および SDK の主な変更点。日時は UTC です。

API

2026-06-20

• /v1/validate レスポンスに captcha_args オブジェクトを返すようになりました。ログ記録やお客様独自のリスクスコアリングのために、解答時のコンテキストを返します（合否判定には不要です）。
  • platform — web / android / ios / flutter / windows / …
  • user_ip — 解答時に記録されたエンドユーザーの IP
  • referer — 解答ページの URL（web）。ネイティブでは null
  • pkg — アプリのパッケージ／バンドル 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 引数は任意ですが推奨になりました。後方互換性があります。