---
title: Değişiklik günlüğü
---

# Değişiklik günlüğü

CaptchaLa API ve SDK'larındaki önemli değişiklikler. Tarihler UTC'dir.

## API

### 2026-06-20

- **`/v1/validate` yanıtı** artık bir `captcha_args` nesnesi döndürür —
  günlükleme / kendi risk puanlamanız için geri yansıtılan çözüm anı bağlamı
  (geçti/kaldı için asla gerekli değildir):
  - `platform` — `web` / `android` / `ios` / `flutter` / `windows` / …
  - `user_ip` — çözüm anında kaydedilen son kullanıcı IP'si
  - `referer` — çözüm sayfası URL'si (web); natif platformlarda `null`
  - `pkg` — uygulama paketi / bundle kimliği (natif); web'de `null`
  - `solved_at` — çözüm tamamlanma zamanı (unix saniye)
  - `risk_score` — çözüm anı risk puanı (0-100, yüksek = daha riskli)
- **`/v1/validate` üzerindeki `client_ip`** **isteğe bağlıdır ancak önerilir** —
  gelen isteğinizdeki son kullanıcının IP'si, ek risk kontrolleri için
  kullanılır. Atlanması güvenlidir. (Çözüm-ile-gönderim arasındaki tam IP
  eşleştirmesi, CDN + çift yığın IPv4/IPv6 ağlarında meşru kullanıcıları
  reddettiği için kaldırıldı.)
- Tamamen geriye dönük uyumludur — mevcut entegrasyonlar değişmeden çalışmaya
  devam eder.

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

### 1.2.3 — 2026-06-20

- `ValidateResult::getUserIp()` ve `ValidateResult::getCaptchaArgs()` eklendi.
- `validate()` metodunun `$clientIp` parametresi artık isteğe bağlı ancak
  önerilir (risk kontrolleri için kullanılır). Geriye dönük uyumludur.

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

### 1.2.2 — 2026-06-20

- `ValidateResult.CaptchaArgs` eklendi (`CaptchaArgs` struct: `Platform`,
  `UserIP`, `Referer`, `Pkg`, `SolvedAt`, `RiskScore`).
- `ValidateWithClientIP` metodunun IP argümanı artık isteğe bağlı ancak
  önerilir. Geriye dönük uyumludur.