Değişiklik günlüğü

CaptchaLa API ve SDK'larındaki önemli değişiklikler. Tarihler UTC'dir.

API

/v1/validate yanıtı artık bir captcha_args nesnesi döndürür — günlükleme / kendi risk puanlamanız için geri yansıtılan çözüm anı bağlamı (geçti/kaldı için asla gerekli değildir):
- platform — web / android / ios / flutter / windows / …
- user_ip — çözüm anında kaydedilen son kullanıcı IP'si
- referer — çözüm sayfası URL'si (web); natif platformlarda null
- pkg — uygulama paketi / bundle kimliği (natif); web'de null
- solved_at — çözüm tamamlanma zamanı (unix saniye)
- risk_score — çözüm anı risk puanı (0-100, yüksek = daha riskli)
/v1/validate üzerindeki client_ip isteğe bağlıdır ancak önerilir — gelen isteğinizdeki son kullanıcının IP'si, ek risk kontrolleri için kullanılır. Atlanması güvenlidir. (Çözüm-ile-gönderim arasındaki tam IP eşleştirmesi, CDN + çift yığın IPv4/IPv6 ağlarında meşru kullanıcıları reddettiği için kaldırıldı.)
Tamamen geriye dönük uyumludur — mevcut entegrasyonlar değişmeden çalışmaya devam eder.

ValidateResult::getUserIp() ve ValidateResult::getCaptchaArgs() eklendi.
validate() metodunun $clientIp parametresi artık isteğe bağlı ancak önerilir (risk kontrolleri için kullanılır). Geriye dönük uyumludur.

ValidateResult.CaptchaArgs eklendi (CaptchaArgs struct: Platform, UserIP, Referer, Pkg, SolvedAt, RiskScore).
ValidateWithClientIP metodunun IP argümanı artık isteğe bağlı ancak önerilir. Geriye dönük uyumludur.