---
title: Catatan perubahan
---

# Catatan perubahan

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

## API

### 2026-06-20

- **Respons `/v1/validate`** kini mengembalikan objek `captcha_args` — konteks
  pada saat penyelesaian yang dipantulkan kembali untuk pencatatan / penilaian
  risiko Anda sendiri (tidak pernah diperlukan untuk lulus/gagal):
  - `platform` — `web` / `android` / `ios` / `flutter` / `windows` / …
  - `user_ip` — IP pengguna akhir yang dicatat pada saat penyelesaian
  - `referer` — URL halaman penyelesaian (web); `null` pada platform native
  - `pkg` — id paket / bundle aplikasi (native); `null` pada web
  - `solved_at` — waktu penyelesaian selesai (detik unix)
  - `risk_score` — skor risiko pada saat penyelesaian (0-100, lebih tinggi = lebih berisiko)
- **`client_ip`** pada `/v1/validate` bersifat **opsional tetapi disarankan** —
  IP pengguna akhir dari permintaan masuk Anda, digunakan untuk pemeriksaan
  risiko tambahan. Aman untuk dihilangkan. (Pencocokan IP yang tepat antara
  penyelesaian dan pengiriman dihapus karena menolak pengguna sah pada jaringan
  CDN + dual-stack IPv4/IPv6.)
- Sepenuhnya kompatibel ke belakang — integrasi yang ada tetap berfungsi tanpa
  perubahan.

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

### 1.2.3 — 2026-06-20

- Menambahkan `ValidateResult::getUserIp()` dan `ValidateResult::getCaptchaArgs()`.
- `$clientIp` pada `validate()` kini opsional tetapi disarankan (digunakan untuk
  pemeriksaan risiko). Kompatibel ke belakang.

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

### 1.2.2 — 2026-06-20

- Menambahkan `ValidateResult.CaptchaArgs` (struct `CaptchaArgs`: `Platform`,
  `UserIP`, `Referer`, `Pkg`, `SolvedAt`, `RiskScore`).
- Argumen IP pada `ValidateWithClientIP` kini opsional tetapi disarankan.
  Kompatibel ke belakang.