Nhật ký thay đổi

Những thay đổi đáng chú ý của API và SDK CaptchaLa. Thời gian theo UTC.

API

Phản hồi của /v1/validate giờ trả về một đối tượng captcha_args — ngữ cảnh tại thời điểm giải được trả lại để ghi log / chấm điểm rủi ro của riêng bạn (không bao giờ bắt buộc cho việc đạt/không đạt):
- platform — web / android / ios / flutter / windows / …
- user_ip — IP của người dùng cuối được ghi lại tại thời điểm giải
- referer — URL trang giải (web); null trên nền tảng native
- pkg — package ứng dụng / bundle id (native); null trên web
- solved_at — thời điểm hoàn thành giải (giây unix)
- risk_score — điểm rủi ro tại thời điểm giải (0-100, càng cao càng rủi ro)
client_ip trên /v1/validate là tùy chọn nhưng được khuyến nghị — IP của người dùng cuối lấy từ request đến của bạn, dùng cho các kiểm tra rủi ro bổ sung. Có thể bỏ qua một cách an toàn. (Việc đối chiếu chính xác IP lúc giải với lúc gửi đã bị loại bỏ vì nó từ chối những người dùng hợp lệ trên mạng CDN và mạng IPv4/IPv6 dual-stack.)
Hoàn toàn tương thích ngược — các tích hợp hiện có vẫn hoạt động bình thường mà không cần thay đổi.

Đã thêm ValidateResult::getUserIp() và ValidateResult::getCaptchaArgs().
Tham số $clientIp của validate() giờ là tùy chọn nhưng được khuyến nghị (dùng cho kiểm tra rủi ro). Tương thích ngược.

Đã thêm ValidateResult.CaptchaArgs (struct CaptchaArgs: Platform, UserIP, Referer, Pkg, SolvedAt, RiskScore).
Tham số IP của ValidateWithClientIP giờ là tùy chọn nhưng được khuyến nghị. Tương thích ngược.