---
title: Änderungsprotokoll
---

# Änderungsprotokoll

Wesentliche Änderungen an der CaptchaLa-API und den SDKs. Alle Datumsangaben in UTC.

## API

### 2026-06-20

- **Die Antwort von `/v1/validate`** gibt jetzt ein `captcha_args`-Objekt zurück
  — der zum Lösungszeitpunkt zurückgegebene Kontext für Protokollierung / Ihre
  eigene Risikobewertung (nie erforderlich für Bestehen/Fehlschlag):
  - `platform` — `web` / `android` / `ios` / `flutter` / `windows` / …
  - `user_ip` — IP des Endnutzers, zum Lösungszeitpunkt erfasst
  - `referer` — URL der Lösungsseite (Web); `null` bei nativen Apps
  - `pkg` — Paket-/Bundle-ID der App (nativ); `null` im Web
  - `solved_at` — Zeitpunkt des Lösungsabschlusses (Unix-Sekunden)
  - `risk_score` — Risikobewertung zum Lösungszeitpunkt (0-100, höher = riskanter)
- **`client_ip`** bei `/v1/validate` ist **optional, aber empfohlen** — die IP
  des Endnutzers aus Ihrer eingehenden Anfrage, genutzt für zusätzliche
  Risikoprüfungen. Kann gefahrlos weggelassen werden. (Der exakte Abgleich der
  IP zwischen Lösung und Übermittlung wurde verworfen, da er legitime Nutzer in
  CDN- und Dual-Stack-IPv4/IPv6-Netzwerken abgelehnt hat.)
- Vollständig abwärtskompatibel — bestehende Integrationen funktionieren
  unverändert weiter.

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

### 1.2.3 — 2026-06-20

- `ValidateResult::getUserIp()` und `ValidateResult::getCaptchaArgs()`
  hinzugefügt.
- Das `$clientIp` von `validate()` ist jetzt optional, aber empfohlen (für
  Risikoprüfungen verwendet). Abwärtskompatibel.

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

### 1.2.2 — 2026-06-20

- `ValidateResult.CaptchaArgs` hinzugefügt (`CaptchaArgs`-Struct: `Platform`,
  `UserIP`, `Referer`, `Pkg`, `SolvedAt`, `RiskScore`).
- Das IP-Argument von `ValidateWithClientIP` ist jetzt optional, aber empfohlen.
  Abwärtskompatibel.