Registro de cambios

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

API

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.

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

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