---
title: Registro de alterações
---

# Registro de alterações

Alterações importantes na API e nos SDKs do CaptchaLa. As datas estão em UTC.

## API

### 2026-06-20

- **Resposta de `/v1/validate`** agora retorna um objeto `captcha_args` — o
  contexto do momento da resolução devolvido para registro / sua própria
  pontuação de risco (nunca obrigatório para aprovar/reprovar):
  - `platform` — `web` / `android` / `ios` / `flutter` / `windows` / …
  - `user_ip` — IP do usuário final registrado no momento da resolução
  - `referer` — URL da página de resolução (web); `null` no nativo
  - `pkg` — identificador do pacote / bundle do app (nativo); `null` na web
  - `solved_at` — horário de conclusão da resolução (segundos unix)
  - `risk_score` — pontuação de risco no momento da resolução (0-100, maior =
    mais arriscado)
- **`client_ip`** em `/v1/validate` é **opcional, mas recomendado** — o IP do
  usuário final da sua requisição de entrada, usado para verificações de risco
  adicionais. É seguro omitir. (A correspondência exata de IP entre resolução e
  envio foi removida porque rejeitava usuários legítimos em redes com CDN e
  pilha dupla IPv4/IPv6.)
- Totalmente compatível com versões anteriores — as integrações existentes
  continuam funcionando sem alterações.

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

### 1.2.3 — 2026-06-20

- Adicionados `ValidateResult::getUserIp()` e `ValidateResult::getCaptchaArgs()`.
- O `$clientIp` de `validate()` agora é opcional, mas recomendado (usado para
  verificações de risco). Compatível com versões anteriores.

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

### 1.2.2 — 2026-06-20

- Adicionado `ValidateResult.CaptchaArgs` (estrutura `CaptchaArgs`: `Platform`,
  `UserIP`, `Referer`, `Pkg`, `SolvedAt`, `RiskScore`).
- O argumento de IP de `ValidateWithClientIP` agora é opcional, mas recomendado.
  Compatível com versões anteriores.