---
title: Журнал изменений
---

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

Важные изменения в 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` теперь необязательный, но рекомендуемый.
  Обратно совместимо.