> 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/pt-br/deprecation-schedule-policy/api-deprecation-policy.md). # Política de Descontinuação da API ## Por que descontinuamos Aqui na Epsilon Retail Media estamos constantemente iterando e introduzindo novos produtos e recursos. Como tal, as alterações em nossas APIs serão inevitáveis. Para ajudar nossos usuários a se planejarem para as mudanças, seguimos uma política de descontinuação quando uma versão melhor está disponível ou quando um recurso está próximo do ou no fim do suporte. O período de descontinuação de uma versão começa na data do anúncio da descontinuação. As versões marcadas para descontinuação continuarão disponíveis durante todo o período de descontinuação de 3 meses. Assim que o período de descontinuação decorrer, espera-se que a versão seja desativada, e a Epsilon Retail Media não poderá mais garantir que ela estará disponível a partir da data de encerramento. ## Regras aplicadas para a descontinuação de nossas APIs 1. Alterações incompatíveis, como elementos de API removidos, só são introduzidas ao incrementar a versão da API. * Depois que um elemento de API for adicionado em uma versão específica, ele não poderá ser removido dessa versão nem ter seu comportamento significativamente alterado 2. Os objetos de API devem ser capazes de fazer o transporte de ida e volta (round-trip) entre as versões de API em um determinado lançamento com perda mínima ou nenhuma de informações, com exceção de recursos REST inteiros que não existem em algumas versões. * Exemplo: um objeto pode ser gravado como v1, lido novamente como v2 e convertido para v1, e o recurso v1 resultante será idêntico ao original. A representação em v2 pode ser diferente de v1, mas o sistema sabe como converter entre elas em ambas as direções. Além disso, qualquer novo campo adicionado em v2 deve ser capaz de fazer o transporte de ida e volta para v1 e de volta, o que significa que v1 pode ter que adicionar um campo equivalente, mapear para um campo equivalente ou representá-lo como uma anotação. * Com alterações significativas nos recursos do produto, faremos todos os esforços para projetar nossas APIs para serem compatíveis com versões anteriores, mas pode haver circunstâncias excepcionais em que isso não seja possível. Discutiremos essas exceções com nossos parceiros. 3. Uma versão de API não pode ser descontinuada em favor de uma versão de API menos estável. * Uma versão de API de Disponibilidade Geral (GA) pode substituir as versões Alpha e Beta menos estáveis * As versões Beta podem substituir versões Beta ou Alpha anteriores, mas não podem ser usadas para substituir uma versão de API GA * As versões Alpha podem substituir versões Alpha anteriores, mas não podem ser usadas para substituir uma versão Beta ou a versão GA 4. As versões de API marcadas para descontinuação serão suportadas por até 3 meses a partir da data do aviso. Anunciaremos quando o suporte e a disponibilidade da versão terminarem. As versões Alpha e Beta podem ser descontinuadas antes, à medida que uma versão de API GA preferencial for introduzida. * Novas versões de API só serão introduzidas como parte de uma versão que suporte tanto a nova versão quanto a versão anterior * Isso dá tempo para os usuários migrarem para a versão mais recente ou reverterem quando necessário, dentro do período de tempo em que a versão anterior não estiver mais disponível e tiver sido desativada 5. Fazer chamadas em uma versão desativada pode resultar em comportamento imprevisível ou resposta inválida. ## Exceções Uma política não pode cobrir todas as situações possíveis. Este é um documento vivo e sempre evoluirá com o tempo. Onde houver situações que não se encaixem perfeitamente nesta política, ou para as quais esta política se torne um sério impedimento, discuta o desafio com a equipe da para encontrar as melhores soluções para esses casos específicos. Epsilon Retail Media está comprometida em fornecer uma integração estável que, o máximo possível, não interrompa nossos usuários. As exceções serão sempre anunciadas em todas as notas de lançamento relevantes. --- # 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/pt-br/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.