> 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/de/deprecation-schedule-policy/api-deprecation-policy.md). # API-Veralterungsrichtlinie ## Warum wir Funktionen einstellen Hier bei Epsilon Retail Media entwickeln wir kontinuierlich neue Produkte und Funktionen. Daher sind Änderungen an unseren APIs unvermeidbar. Um unseren Nutzern die Planung von Änderungen zu erleichtern, folgen wir einer Einstellungsrichtlinie, wenn eine bessere Version verfügbar ist oder eine Funktion das Ende des Supports erreicht oder kurz davor steht. Der Einstellungszeitraum für eine Version beginnt mit dem Ankündigungsdatum der Einstellung. Die zur Einstellung markierten Versionen bleiben während des Einstellungszeitraums von 3 Monaten weiterhin verfügbar. Nach Ablauf des Einstellungszeitraums wird die Version voraussichtlich ausser Betrieb genommen, und Epsilon Retail Media kann ab dem Einstellungstag nicht mehr garantieren, dass sie verfügbar ist. ## Erzwungene Einstellungsregeln für unsere APIs 1. Grundlegende Änderungen wie entfernte API-Elemente werden nur durch Erhöhung der Version der API eingeführt. * Sobald ein API-Element zu einer bestimmten Version hinzugefügt wurde, kann es nicht mehr aus dieser Version entfernt oder sein Verhalten erheblich geändert werden. 2. API-Objekte müssen in der Lage sein, zwischen API-Versionen in einem bestimmten Release mit minimalem bis gar keinem Informationsverlust hin- und hergewandelt zu werden, mit Ausnahme ganzer REST-Ressourcen, die in einigen Versionen nicht existieren. * Beispiel: Ein Objekt kann als v1 geschrieben, dann als v2 zurückgelesen und in v1 konvertiert werden, und die resultierende v1-Ressource ist identisch mit dem Original. Die Darstellung in v2 unterscheidet sich möglicherweise von v1, aber das System weiß, wie es in beiden Richtungen zwischen ihnen konvertiert. Darüber hinaus muss jedes in v2 hinzugefügte neue Feld in der Lage sein, eine Konvertierung nach v1 und zurück durchzulaufen. Das bedeutet, dass v1 möglicherweise ein äquivalentes Feld hinzufügen, auf ein äquivalentes Feld verweisen oder es als Anmerkung darstellen muss. * Bei bedeutenden Produktfunktionsänderungen werden wir alle Anstrengungen unternehmen, um unsere APIs abwärtskompatibel zu gestalten. Es kann jedoch außergewöhnliche Umstände geben, in denen dies nicht möglich ist. Wir werden diese Ausnahmen mit unseren Partnern besprechen. 3. Eine API-Version darf nicht zugunsten einer weniger stabilen API-Version eingestellt werden. * Eine General Availability (GA) API-Version kann die weniger stabilen Alpha- und Beta-Versionen ersetzen. * Beta-Versionen können frühere Beta- oder Alpha-Versionen ersetzen, dürfen jedoch nicht verwendet werden, um eine GA API-Version zu ersetzen. * Alpha-Versionen können frühere Alpha-Versionen ersetzen, dürfen jedoch nicht verwendet werden, um eine Beta- oder die GA-Version zu ersetzen. 4. API-Versionen, die zur Einstellung markiert sind, werden bis zu 3 Monate ab dem Benachrichtigungsdatum unterstützt. Wir werden ankündigen, wann der Support und die Verfügbarkeit der Version enden. Alpha- und Beta-Versionen können früher eingestellt werden, wenn eine bevorzugte GA API-Version eingeführt wird. * Neue API-Versionen werden nur als Teil eines Releases eingeführt, der sowohl die neue Version als auch die vorherige Version unterstützt. * Dies gibt Nutzern Zeit, auf die neueste Version zu migrieren oder bei Bedarf innerhalb des Zeitraums zurückzukehren, in dem die vorherige Version nicht mehr verfügbar ist und außer Betrieb genommen wurde. 5. Der Aufruf einer außer Betrieb genommenen Version kann zu unvorhersehbarem Verhalten oder ungültigen Antworten führen. ## Ausnahmen Eine Richtlinie kann nicht jede mögliche Situation abdecken. Dies ist ein dynamisches Dokument, das sich im Laufe der Zeit immer weiterentwickeln wird. Wenn es Situationen gibt, die nicht sauber in diese Richtlinie passen oder für die diese Richtlinie zu einem ernsthaften Hindernis wird, besprechen Sie die Herausforderung mit dem Team bei um die besten Lösungen für diese spezifischen Fälle zu finden. Epsilon Retail Media setzt sich dafür ein, eine stabile Integration bereitzustellen, die unsere Nutzer so wenig wie möglich beeinträchtigt. Ausnahmen werden immer in allen relevanten Release Notes angekündigt. --- # 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/de/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.