---
title: Log perubahan
---

# Log perubahan

Perubahan penting pada API dan SDK CaptchaLa. Tarikh dalam UTC.

## API

### 2026-06-20

- **Respons `/v1/validate`** kini mengembalikan objek `captcha_args` — konteks
  pada masa penyelesaian yang dipulangkan semula untuk pengelogan / penskoran
  risiko anda sendiri (tidak pernah diperlukan untuk lulus/gagal):
  - `platform` — `web` / `android` / `ios` / `flutter` / `windows` / …
  - `user_ip` — IP pengguna akhir yang direkodkan pada masa penyelesaian
  - `referer` — URL halaman penyelesaian (web); `null` pada platform natif
  - `pkg` — id pakej / bundle aplikasi (natif); `null` pada web
  - `solved_at` — masa penyelesaian selesai (saat unix)
  - `risk_score` — skor risiko pada masa penyelesaian (0-100, lebih tinggi = lebih berisiko)
- **`client_ip`** pada `/v1/validate` adalah **pilihan tetapi disyorkan** — IP
  pengguna akhir daripada permintaan masuk anda, digunakan untuk pemeriksaan
  risiko tambahan. Selamat untuk ditinggalkan. (Padanan tepat IP penyelesaian
  lawan penghantaran telah digugurkan kerana ia menolak pengguna sah pada
  rangkaian CDN + dwitindanan IPv4/IPv6.)
- Serasi sepenuhnya ke belakang — penyepaduan sedia ada terus berfungsi tanpa
  perubahan.

## PHP SDK (`captchala/captchala-php`)

### 1.2.3 — 2026-06-20

- Menambah `ValidateResult::getUserIp()` dan `ValidateResult::getCaptchaArgs()`.
- `$clientIp` pada `validate()` kini pilihan tetapi disyorkan (digunakan untuk
  pemeriksaan risiko). Serasi ke belakang.

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

### 1.2.2 — 2026-06-20

- Menambah `ValidateResult.CaptchaArgs` (struct `CaptchaArgs`: `Platform`,
  `UserIP`, `Referer`, `Pkg`, `SolvedAt`, `RiskScore`).
- Argumen IP pada `ValidateWithClientIP` kini pilihan tetapi disyorkan. Serasi
  ke belakang.