> 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/sv/deprecation-schedule-policy/api-deprecation-policy.md). # API-policy för avveckling ## Varför vi avvecklar Här på Epsilon Retail Media itererar vi ständigt och introducerar nya produkter och funktioner. Därför är ändringar i våra API:er oundvikliga. För att hjälpa våra användare att planera för ändringar följer vi en avvecklingspolicy när en bättre version finns tillgänglig eller när en funktion närmar sig eller har nått slutet på sin supportperiod. Avvecklingsperioden för en version börjar på meddelandedatumet för avvecklingen. Versionerna som markerats för avveckling kommer att fortsätta vara tillgängliga under hela avvecklingsperioden på 3 månader. När avvecklingsperioden har löpt ut förväntas versionen tas ur drift, och Epsilon Retail Media kan inte längre garantera att den kommer att vara tillgänglig från och med sunset-datumet. ## Verkställda regler för avveckling av våra API:er 1. Gripande ändringar (breaking changes), såsom borttagna API-element, introduceras endast genom att öka API-versionen. * När ett API-element väl har lagts till i en viss version kan det inte tas bort från den versionen eller få sitt beteende avsevärt ändrat 2. API-objekt måste kunna köra tur-och-retur (round-trip) mellan API-versioner i en given releasemed minimal till ingen informationsförlust, med undantag för hela REST-resurser som inte finns i vissa versioner. * Exempelvis kan ett objekt skrivas som v1 och sedan läsas tillbaka som v2 och konverteras till v1, och den resulterande v1-resursen kommer att vara identisk med originalet. Representationen i v2 kan skilja sig från v1, men systemet vet hur man konverterar mellan dem i båda riktningarna. Dessutom måste alla nya fält som läggs till i v2 kunna köra tur-och-retur till v1 och tillbaka, vilket innebär att v1 kan behöva lägga till ett motsvarande fält, mappa till ett motsvarande fält eller representera det som en annotering. * Vid betydande ändringar av produktfunktioner kommer vi att göra allt vi kan för att utforma våra API:er så att de är bakåtkompatibla, men det kan finnas exceptionella omständigheter där detta inte är möjligt. Vi kommer att diskutera dessa undantag med våra partners. 3. En API-version får inte avvecklas till förmån för en mindre stabil API-version. * En General Availability (GA) API-version kan ersätta de mindre stabila Alpha- och Beta-versionerna * Beta-versioner kan ersätta tidigare Beta- eller Alpha-versioner, men får inte användas för att ersätta en GA API-version * Alpha-versioner kan ersätta tidigare Alpha-versioner, men får inte användas för att ersätta en Beta- eller GA-versionen 4. API-versioner som markerats för avveckling kommer att stödjas i upp till 3 månader från meddelandedatumet. Vi kommer att meddela när supporten och tillgängligheten för versionen upphör. Alpha- och Beta-versioner kan avvecklas tidigare om en föredragen GA API-version introduceras. * Nya API-versioner kommer endast att introduceras som en del av en release som stöder både den nya versionen och den föregående versionen * Detta ger användarna tid att migrera till den senaste versionen eller återgå vid behov inom den tidsperiod som den föregående versionen inte längre är tillgänglig och har tagits ur drift 5. Anrop till en version som tagits ur drift kan resultera i oförutsägbart beteende eller ogiltigt svar. ## Undantag En policy kan inte täcka alla tänkbara situationer. Detta är ett levande dokument och kommer alltid att utvecklas över tid. När det uppstår situationer som inte passar in i denna policy, eller för vilka denna policy blir ett allvarligt hinder, diskutera utmaningen med teamet på för att hitta de bästa lösningarna för dessa specifika fall. Epsilon Retail Media är fast beslutna att tillhandahålla en stabil integration som i så stor utsträckning som möjligt inte stör våra användare. Undantag kommer alltid att meddelas i alla relevanta releasenotes. --- # 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/sv/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.