---
title: Journal des modifications
---

# Journal des modifications

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

## API

### 2026-06-20

- **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.

## PHP SDK (`captchala/captchala-php`)

### 1.2.3 — 2026-06-20

- 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.

## Go SDK (`github.com/Captcha-La/captchala-go`)

### 1.2.2 — 2026-06-20

- 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.