> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Journal des modifications

> Nouvelles fonctionnalités, améliorations et évolutions de l’API Chataigne.

Consultez cette page pour suivre les changements de l’API destinée aux clients. Les ajouts compatibles sont publiés dans `/v1` ; les changements incompatibles nécessitent une nouvelle version majeure, comme expliqué dans [Gestion des versions](/fr/concepts/versioning).

<Update label="2026-07-17" tags={["v1", "rupture"]}>
  ## Migration des identifiants de ressources

  Les endpoints d’organisation, d’établissement et de fermeture exceptionnelle utilisent désormais les identifiants de ressources actuels renvoyés par l’API. Les anciens alias de ressources ne sont plus acceptés.

  Les champs de relation, notamment `organization_id`, `location_id`, `location_ids` et `active_location_ids`, utilisent les mêmes identifiants. Les curseurs de pagination utilisent également les identifiants renvoyés par les endpoints de liste.

  <Warning>
    Si votre intégration a enregistré d’anciens alias, remplacez-les par les identifiants renvoyés par l’API actuelle avant d’effectuer de nouvelles requêtes. Traitez tous les identifiants comme des chaînes opaques.
  </Warning>
</Update>

<Update label="2026-05-01" tags={["v1"]}>
  ## Version initiale

  La première version de l’API Chataigne est disponible à l’adresse :

  ```text theme={null}
  https://server.chataigne.ai/v1
  ```

  Les requêtes s’authentifient avec une clé API Chataigne dans l’en-tête `x-api-key`.

  ### Ressources disponibles

  * Découverte des organisations commerciales et mise à jour de leur profil.
  * Découverte, création et mise à jour du profil des établissements.
  * Paramètres de commande, d’horaires, de livraison, d’acceptation et du commis IA.
  * Gestion des fermetures exceptionnelles.
  * Données analytiques des établissements et organisations.

  ### Comportements communs

  * Réponses d’erreur structurées et identifiants de requête.
  * Pagination par curseur et filtres temporels.
  * Clés d’idempotence pour la création de ressources.
  * Développement des établissements d’une organisation dans la réponse.
  * Limites par clé et en-têtes de quota standard.
</Update>