Skip to content

Ä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.6 — 2026-11-12 ​

  • Neu: setRejectClientOnly(true) – reine Client-Tokens auch während eines Ausfalls ablehnen (client_only_rejected_by_policy).
  • Erreichbarkeitsprüfungen für reine Client-Tokens speichern auch „nicht erreichbar“ 5 Sekunden lang, sodass ein Ausfall nicht mehr jede Anfrage verlangsamt. Mit APCu teilen sich alle PHP-FPM-Worker den Cache.
  • issueServerToken() sendet die IP als bind_ip (der dokumentierte Feldname). Abwärtskompatibel.

1.2.5 — 2026-10-27 ​

  • Reine Client-Tokens (client_, co_) werden nur akzeptiert, wenn die CaptchaLa-API nicht erreichbar ist; andernfalls mit client_only_rejected_api_reachable abgelehnt. Neu: Client::isClientOnlyToken().
  • Robustere Behandlung unerwarteter bzw. Nicht-JSON-Antworten.

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.4 — 2026-11-12 ​

  • Neu: Client.RejectClientOnly – reine Client-Tokens auch während eines Ausfalls ablehnen (client_only_rejected_by_policy).
  • Erreichbarkeitsprüfungen für reine Client-Tokens speichern auch „nicht erreichbar“ 5 Sekunden lang, sodass ein Ausfall nicht mehr jede Anfrage verlangsamt. Gleichzeitige Validierungen teilen sich eine Prüfung.
  • IssueServerTokenWithOptions sendet die IP als bind_ip (der dokumentierte Feldname). Abwärtskompatibel.

1.2.3 — 2026-10-27 ​

  • Reine Client-Tokens (client_, co_) werden nur akzeptiert, wenn die CaptchaLa-API nicht erreichbar ist; andernfalls mit client_only_rejected_api_reachable abgelehnt. Neu: IsClientOnlyToken().
  • Robustere Behandlung unerwarteter bzw. Nicht-JSON-Antworten.

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.

MIT-licensed examples · CaptchaLa is operated independently