Änderungsprotokoll
Wesentliche Änderungen an der CaptchaLa-API und den SDKs. Alle Datumsangaben in UTC.
API
2026-06-20
- Die Antwort von
/v1/validategibt jetzt eincaptcha_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 erfasstreferer— URL der Lösungsseite (Web);nullbei nativen Appspkg— Paket-/Bundle-ID der App (nativ);nullim Websolved_at— Zeitpunkt des Lösungsabschlusses (Unix-Sekunden)risk_score— Risikobewertung zum Lösungszeitpunkt (0-100, höher = riskanter)
client_ipbei/v1/validateist 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 alsbind_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 mitclient_only_rejected_api_reachableabgelehnt. Neu:Client::isClientOnlyToken(). - Robustere Behandlung unerwarteter bzw. Nicht-JSON-Antworten.
1.2.3 — 2026-06-20
ValidateResult::getUserIp()undValidateResult::getCaptchaArgs()hinzugefügt.- Das
$clientIpvonvalidate()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.
IssueServerTokenWithOptionssendet die IP alsbind_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 mitclient_only_rejected_api_reachableabgelehnt. Neu:IsClientOnlyToken(). - Robustere Behandlung unerwarteter bzw. Nicht-JSON-Antworten.
1.2.2 — 2026-06-20
ValidateResult.CaptchaArgshinzugefügt (CaptchaArgs-Struct:Platform,UserIP,Referer,Pkg,SolvedAt,RiskScore).- Das IP-Argument von
ValidateWithClientIPist jetzt optional, aber empfohlen. Abwärtskompatibel.