---
title: 更新日志
---

# 更新日志

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 参数改为可选、建议传。向后兼容。