> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/fr/deprecation-schedule-policy/api-deprecation-policy.md). # Politique d'obsolescence de l'API ## Pourquoi nous abandonnons Ici chez Epsilon Retail Media nous itérons constamment et introduisons de nouveaux produits et fonctionnalités. Ainsi, les modifications apportées à nos API seront inévitables. Pour aider nos utilisateurs à planifier ces changements, nous suivons une politique d'obsolescence lorsqu'une meilleure version est disponible ou lorsqu'une fonctionnalité approche ou atteint la fin du support. La période d'obsolescence d'une version commence à la date d'annonce de l'obsolescence. Les versions marquées pour l'obsolescence continueront d'être disponibles tout au long de la période d'obsolescence de 3 mois. Une fois la période d'obsolescence écoulée, la version devrait être décommissionnée, et Epsilon Retail Media ne peut plus garantir qu'elle sera disponible à partir de la date de fin de vie. ## Règles d'obsolescence appliquées pour nos API 1. Les changements majeurs tels que la suppression d'éléments d'API ne sont introduits qu'en incrémentant la version de l'API. * Lorsqu'un élément d'API a été ajouté à une version particulière, il ne peut pas être supprimé de cette version ni voir son comportement modifié de manière significative 2. Les objets d'API doivent pouvoir faire un aller-retour entre les versions d'API dans une version donnée avec une perte d'informations minimale, voire nulle, à l'exception des ressources REST entières qui n'existent pas dans certaines versions. * Exemple : un objet peut être écrit en v1, puis relu en v2 et converti en v1, et la ressource v1 résultante sera identique à l'originale. La représentation en v2 peut être différente de la v1, mais le système sait comment convertir entre elles dans les deux sens. De plus, tout nouveau champ ajouté en v2 doit pouvoir faire un aller-retour vers v1 et inversement, ce qui signifie que v1 peut devoir ajouter un champ équivalent, s'associer à un champ équivalent ou le représenter sous forme d'annotation. * Lors de modifications significatives des fonctionnalités du produit, nous ferons tout notre possible pour concevoir nos API de manière à ce qu'elles soient rétrocompatibles, mais il peut y avoir des circonstances exceptionnelles où cela n'est pas possible. Nous discuterons de ces exceptions avec nos partenaires. 3. Une version d'API ne peut pas être abandonnée au profit d'une version d'API moins stable. * Une version d'API en disponibilité générale (GA) peut remplacer les versions Alpha et Beta moins stables * Les versions Beta peuvent remplacer des versions Beta ou Alpha antérieures, mais ne peuvent pas être utilisées pour remplacer une version d'API GA * Les versions Alpha peuvent remplacer des versions Alpha antérieures, mais ne peuvent pas être utilisées pour remplacer une version Beta ou la version GA 4. Les versions d'API marquées pour l'obsolescence seront prises en charge pendant un maximum de 3 mois à compter de la date de préavis. Nous annoncerons la fin de la prise en charge et de la disponibilité de la version. Les versions Alpha et Beta peuvent être abandonnées plus tôt lorsqu'une version d'API GA préférée est introduite. * Les nouvelles versions d'API ne seront introduites que dans le cadre d'une version qui prend en charge à la fois la nouvelle version et la version précédente * Cela laisse le temps aux utilisateurs de migrer vers la dernière version ou de revenir en arrière si nécessaire pendant la période où la version précédente n'est plus disponible et a été décommissionnée 5. L'appel d'une version décommissionnée peut entraîner un comportement imprévisible ou une réponse invalide. ## Exceptions Une politique ne peut pas couvrir toutes les situations possibles. Il s'agit d'un document évolutif qui s'adaptera toujours avec le temps. En cas de situations qui ne s'inscrivent pas clairement dans cette politique, ou pour lesquelles cette politique devient un obstacle sérieux, discutez du problème avec l'équipe de afin de trouver les meilleures solutions pour ces cas spécifiques. Epsilon Retail Media s'engage à fournir une intégration stable qui, autant que possible, ne perturbe pas nos utilisateurs. Les exceptions seront toujours annoncées dans toutes les notes de version pertinentes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/partner/fr/deprecation-schedule-policy/api-deprecation-policy.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.