---
title: Registro de cambios
---

# Registro de cambios

Cambios destacados en la API y los SDK de CaptchaLa. Las fechas están en UTC.

## API

### 2026-06-20

- **Respuesta de `/v1/validate`** ahora devuelve un objeto `captcha_args` — el
  contexto del momento de resolución devuelto para registro / tu propia
  puntuación de riesgo (nunca es obligatorio para aprobar/rechazar):
  - `platform` — `web` / `android` / `ios` / `flutter` / `windows` / …
  - `user_ip` — IP del usuario final registrada en el momento de la resolución
  - `referer` — URL de la página de resolución (web); `null` en nativo
  - `pkg` — identificador del paquete / bundle de la app (nativo); `null` en web
  - `solved_at` — hora de finalización de la resolución (segundos unix)
  - `risk_score` — puntuación de riesgo en el momento de la resolución (0-100,
    mayor = más arriesgado)
- **`client_ip`** en `/v1/validate` es **opcional pero recomendado** — la IP
  del usuario final de tu solicitud entrante, usada para comprobaciones de
  riesgo adicionales. Es seguro omitirla. (La coincidencia exacta de IP entre
  resolución y envío se eliminó porque rechazaba a usuarios legítimos en redes
  con CDN y doble pila IPv4/IPv6.)
- Totalmente retrocompatible — las integraciones existentes siguen funcionando
  sin cambios.

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

### 1.2.3 — 2026-06-20

- Se agregaron `ValidateResult::getUserIp()` y `ValidateResult::getCaptchaArgs()`.
- El `$clientIp` de `validate()` ahora es opcional pero recomendado (usado para
  comprobaciones de riesgo). Retrocompatible.

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

### 1.2.2 — 2026-06-20

- Se agregó `ValidateResult.CaptchaArgs` (estructura `CaptchaArgs`: `Platform`,
  `UserIP`, `Referer`, `Pkg`, `SolvedAt`, `RiskScore`).
- El argumento IP de `ValidateWithClientIP` ahora es opcional pero recomendado.
  Retrocompatible.