---
title: 更新日誌
---

# 更新日誌

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 參數現在為選填但建議提供。向後相容。