Journal des modifications

Modifications notables de l'API et des SDK CaptchaLa. Les dates sont en UTC.

API

La réponse de /v1/validate renvoie désormais un objet captcha_args — le contexte au moment de la résolution renvoyé pour la journalisation / votre propre évaluation de risque (jamais requis pour la réussite/l'échec) :
- platform — web / android / ios / flutter / windows / …
- user_ip — IP de l'utilisateur final enregistrée au moment de la résolution
- referer — URL de la page de résolution (web) ; null en natif
- pkg — identifiant du paquet / bundle de l'application (natif) ; null sur le web
- solved_at — heure de fin de résolution (secondes unix)
- risk_score — score de risque au moment de la résolution (0-100, plus élevé = plus risqué)
client_ip sur /v1/validate est facultatif mais recommandé — l'IP de l'utilisateur final issue de votre requête entrante, utilisée pour des contrôles de risque supplémentaires. Vous pouvez l'omettre sans problème. (La correspondance exacte d'IP entre résolution et soumission a été abandonnée car elle rejetait des utilisateurs légitimes sur les réseaux CDN et à double pile IPv4/IPv6.)
Entièrement rétrocompatible — les intégrations existantes continuent de fonctionner sans modification.

Ajout de ValidateResult::getUserIp() et ValidateResult::getCaptchaArgs().
Le $clientIp de validate() est désormais facultatif mais recommandé (utilisé pour les contrôles de risque). Rétrocompatible.

Ajout de ValidateResult.CaptchaArgs (structure CaptchaArgs : Platform, UserIP, Referer, Pkg, SolvedAt, RiskScore).
L'argument IP de ValidateWithClientIP est désormais facultatif mais recommandé. Rétrocompatible.