> 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/cs/deprecation-schedule-policy/api-deprecation-policy.md).

# Pravidla ukončení podpory API

## Proč ukončujeme podporu

Zde v Epsilon Retail Media neustále inovujeme a zavádíme nové produkty a funkce. Z toho důvodu jsou změny v našich API nevyhnutelné. Abychom našim uživatelům pomohli tyto změny naplánovat, řídíme se zásadami zastarávání v případech, kdy je k dispozici lepší verze nebo kdy se funkce blíží ke konci podpory či na něm již je.

Období zastarávání verze začíná datem oznámení o ukončení podpory. Verze označené k ukončení podpory budou i nadále k dispozici po celé 3měsíční období zastarávání. Po uplynutí období zastarávání se očekává, že verze bude vyřazena z provozu, a Epsilon Retail Media již nemůže zaručit, že bude od data ukončení provozu (sunset date) k dispozici.

## Pravidla ukončování podpory vynucená pro naší API

1. Zpětně nekompatibilní změny (breaking changes), jako je odebrání prvků API, se zavádějí pouze zvýšením verze API.
   * Jakmile byl prvek API přidán v konkrétní verzi, nelze jej z této verze odebrat ani výrazně změnit jeho chování.
2. Objekty API musí být schopny obousměrného převodu (round-trip) mezi verzemi API v daném vydání s minimální nebo žádnou ztrátou informací, s výjimkou celých zdrojů REST, které v některých verzích neexistují.
   * Příklad: objekt lze zapsat jako v1, následně načíst jako v2 a převést zpět na v1, přičemž výsledný zdroj v1 bude identický s originálem. Reprezentace ve v2 se může od v1 lišit, ale systém ví, jak mezi nimi převádět v obou směrech. Libovolné nové pole přidané ve v2 navíc musí být schopné obousměrného převodu do v1 a zpět, což znamená, že v1 možná bude muset přidat ekvivalentní pole, mapovat na ekvivalentní pole nebo jej reprezentovat jako anotaci.
   * Při významných změnách produktových funkcí vynaložíme veškeré úsilí k tomu, abychom naši API navrhli jako zpětně kompatibilní, mohou však nastat výjimečné okolnosti, kdy to nebude možné. Tyto výjimky budeme s našimi partnery konzultovat.
3. Verze API nesmí být označena jako zastaralá ve prospěch méně stabilní verze API.
   * Verze API ve fázi Všeobecné dostupnosti (GA) může nahradit méně stabilní verze Alpha a Beta.
   * Verze Beta mohou nahradit dřívější verze Beta nebo Alpha, ale nesmí být použity k nahrazení verze API ve fázi GA.
   * Verze Alpha mohou nahradit dřívější verze Alpha, ale nesmí být použity k nahrazení verze Beta nebo GA.
4. Verze API označené k ukončení podpory budou podporovány po dobu až 3 měsíců od data oznámení. Oznámíme, kdy podpora a dostupnost dané verze skončí. Verze Alpha a Beta mohou být označeny jako zastaralé dříve, pokud je zavedena preferovaná verze API ve fázi GA.

* Nové verze API budou zaváděny pouze jako součást vydání, které podporuje jak novou verzi, tak verzi předchozí.
* To poskytuje uživatelům čas na migraci na nejnovější verzi nebo na návrat k předchozí verzi v případě potřeby, než přestane být předchozí verze dostupná a bude vyřazena z provozu.

5. Volání vyřazené verze může mít za následek nepředvídatelné chování nebo neplatnou odpověď.

## Výjimky

Zásady nemohou pokrýt každou možnou situaci. Jedná se o živý dokument, který se bude s časem vždy vyvíjet. Pokud nastanou situace, které do těchto zásad přesně nezapadají, nebo pro které se tyto zásady stanou vážnou překážkou, projednejte daný problém s týmem v <support@citrusad.com> abyste našli nejlepší řešení pro tyto konkrétní případy. Epsilon Retail Media se zavazuje poskytovat stabilní integraci, která co nejvíce nenarušuje práci našich uživatelů. Výjimky budou vždy oznámeny ve všech relevantních poznámkách k vydání (release notes).


---

# 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/cs/deprecation-schedule-policy/api-deprecation-policy.md?ask=<question>&goal=<endgoal>
```

`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.