# Journal des modifications de l'API — Additif, jamais cassant

> Historique des versions de l'API v1 d'ImageToTable.ai — chaque nouveau champ ou endpoint est additif et ne constitue jamais un changement cassant. Ce journal répertorie donc les nouveautés sans sous-entendre que vous devez mettre à jour vos intégrations existantes.

Notre politique de versioning : les nouveaux champs et les nouveaux endpoints sont additifs et ne comptent jamais comme un changement cassant sous le préfixe `/api/v1/` — supprimer ou modifier le sens d'un champ existant nécessiterait une v2. Cela signifie que vous pouvez considérer chaque entrée ci-dessous comme « voici ce qui est nouveau », et non « voici ce qui pourrait casser votre intégration ».

## 2026-07-20

- **Les webhooks de batch se réarment désormais automatiquement lorsque vous retraitez un batch.** Si vous ajoutez plus de documents dans un batch qui vous a déjà notifié une fois et que vous appelez `process` à nouveau, vous serez désormais notifié à nouveau lorsque cette nouvelle vague se termine — plus besoin de refaire un `PUT` du webhook. Consultez le [guide Webhooks](/developers/guides/webhooks#reprocessing-a-batch). Si votre intégration réenregistre actuellement le webhook avant chaque vague comme solution de contournement, vous pouvez cesser de le faire en toute sécurité — cet appel n'a en fait jamais rien réarmé.
- **Les jobs d'annotation Bbox déclenchent désormais un événement webhook.** Un événement `document.bbox_completed` est déclenché sur le webhook du batch du document lorsqu'un job bbox atteint un statut terminal — auparavant, les complétions bbox ne produisaient aucune notification, quelle que soit l'inscription. Consultez le [guide Webhooks](/developers/guides/webhooks#event-envelope).
- **`remaining_batch_capacity` ajouté aux réponses `POST /documents`.** Vous indique combien de documents supplémentaires ce batch peut accepter avant d'atteindre la taille maximale de batch de votre plan, sans avoir à appeler `GET /account` séparément.
- **Les livraisons de `document.bbox_completed` sont désormais réclamées de manière atomique, comme `batch.completed`.** Un job bbox dont les groupes de lignes se terminent à quelques instants d'intervalle sur des threads différents déclenchait parfois deux livraisons distinctes pour ce qui était logiquement une seule complétion — vous ne devriez plus voir cela. Si votre intégration dédoublonnait ces événements par `data.group_batch_id` comme solution de contournement, cela reste inoffensif.

## 2026-07-16

- **Lancement de l'API v1.** Publication publique de `/api/v1/`, couvrant les ressources Documents, Batches, Templates & Fields, Webhooks et Account pour le mode de traitement `table` (extraction structurée de champs). Consultez l'[Aperçu de l'API](/developers/) pour commencer.

---

Source: https://imagetotable.ai/fr/developers/changelog