> 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/it/deprecation-schedule-policy/api-deprecation-policy.md). # Politica di deprecazione dell'API ## Perché deprecano Qui a Epsilon Retail Media reitera e introduce costantemente nuovi prodotti e funzionalità. Di conseguenza, le modifiche alle nostre API saranno inevitabili. Per aiutare i nostri utenti a pianificare le modifiche, seguiamo un'informativa sulla deprecazione laddove sia disponibile una versione migliore o una funzionalità sia prossima o giunta al termine del supporto. Il periodo di deprecazione per una versione inizia dalla data di annuncio della deprecazione. Le versioni contrassegnate per la deprecazione continueranno a essere disponibili durante tutto il periodo di deprecazione di 3 mesi. Una volta decorso il periodo di deprecazione, è prevista la dismissione della versione e Epsilon Retail Media non può più garantire che sarà disponibile a partire dalla data di dismissione (sunset date). ## Regole applicate per la deprecazione delle nostre API 1. Le modifiche di rottura (breaking changes) come la rimozione di elementi dell'API vengono introdotte solo aumentando la versione dell'API. * Una volta aggiunto un elemento dell'API a una determinata versione, questo non può essere rimosso da quella versione né il suo comportamento può essere modificato in modo significativo 2. Gli oggetti dell'API devono essere in grado di effettuare un round-trip tra le versioni dell'API in una determinata release con una perdita di informazioni minima o nulla, fatta eccezione per intere risorse REST che non esistono in alcune versioni. * Ad esempio, un oggetto può essere scritto come v1 e quindi letto come v2 e convertito in v1, e la risorsa v1 risultante sarà identica all'originale. La rappresentazione in v2 potrebbe essere diversa da v1, ma il sistema sa come effettuare la conversione tra di esse in entrambe le direzioni. Inoltre, qualsiasi nuovo campo aggiunto in v2 deve essere in grado di effettuare il round-trip a v1 e viceversa, il che significa che v1 potrebbe dover aggiungere un campo equivalente, mapparsi su un campo equivalente o rappresentarlo come un'annotazione. * In presenza di modifiche significative alle funzionalità del prodotto, faremo ogni sforzo per progettare le nostre API in modo che siano retrocompatibili, ma potrebbero verificarsi circostanze eccezionali in cui ciò potrebbe non essere possibile. Discuteremo queste eccezioni con i nostri partner. 3. Una versione dell'API non può essere deprecata a favore di una versione dell'API meno stabile. * Una versione dell'API a disponibilità generale (GA) può sostituire le versioni Alpha e Beta meno stabili * Le versioni Beta possono sostituire le versioni Beta o Alpha precedenti, ma non possono essere utilizzate per sostituire una versione dell'API GA * Le versioni Alpha possono sostituire le versioni Alpha precedenti, ma non possono essere utilizzate per sostituire una versione Beta o la versione GA 4. Le versioni dell'API contrassegnate per la deprecazione saranno supportate per un massimo di 3 mesi dalla data di comunicazione. Annunceremo quando termineranno il supporto e la disponibilità della versione. Le versioni Alpha e Beta potrebbero essere deprecate prima con l'introduzione di una versione dell'API GA preferita. * Le nuove versioni dell'API verranno introdotte solo nell'ambito di una release che supporta sia la nuova versione sia la versione precedente * Questo concede il tempo necessario agli utenti per migrare all'ultima versione o effettuare il roll back quando necessario, entro il periodo di tempo in cui la versione precedente non è più disponibile ed è stata dismessa 5. L'invocazione di una versione dismessa può comportare un comportamento imprevedibile o una risposta non valida. ## Eccezioni Un'informativa non può coprire ogni possibile situazione. Questo è un documento vivo e si evolverà sempre nel tempo. Laddove vi siano situazioni che non rientrano perfettamente in questa informativa, o per le quali questa informativa diventa un serio ostacolo, discuti la questione con il team di per trovare le soluzioni migliori per quei casi specifici. Epsilon Retail Media si impegna a fornire un'integrazione stabile che, per quanto possibile, non danneggi i nostri utenti. Le eccezioni verranno sempre annunciate in tutte le note di rilascio pertinenti. --- # 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/it/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.