Журнал изменений

Важные изменения в API и SDK CaptchaLa. Даты указаны в UTC.

API

2026-06-20

• Ответ /v1/validate теперь возвращает объект captcha_args — контекст на момент решения, возвращаемый обратно для логирования / вашей собственной оценки рисков (никогда не требуется для прохождения/отказа):
  • platform — web / android / ios / flutter / windows / …
  • user_ip — IP конечного пользователя, зафиксированный на момент решения
  • referer — URL страницы решения (web); null на нативных платформах
  • pkg — идентификатор пакета / bundle приложения (нативные); null в web
  • solved_at — время завершения решения (unix-секунды)
  • risk_score — оценка риска на момент решения (0-100, выше = рискованнее)
• client_ip в /v1/validate — необязательный, но рекомендуемый — IP конечного пользователя из вашего входящего запроса, используется для дополнительных проверок рисков. Можно безопасно опустить. (Точное сопоставление IP при решении и при отправке было отключено, так как оно отклоняло легитимных пользователей в сетях CDN и двойного стека IPv4/IPv6.)
• Полностью обратно совместимо — существующие интеграции продолжают работать без изменений.

PHP SDK (captchala/captchala-php)

1.2.3 — 2026-06-20

• Добавлены ValidateResult::getUserIp() и ValidateResult::getCaptchaArgs().
• Параметр $clientIp метода validate() теперь необязательный, но рекомендуемый (используется для проверок рисков). Обратно совместимо.

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

1.2.2 — 2026-06-20

• Добавлено ValidateResult.CaptchaArgs (структура CaptchaArgs: Platform, UserIP, Referer, Pkg, SolvedAt, RiskScore).
• Аргумент IP в ValidateWithClientIP теперь необязательный, но рекомендуемый. Обратно совместимо.