Registro de alterações

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

API

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.

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.

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.