Ä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.