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

# Pravidlá ukončenia podpory API

## Prečo ukončujeme podporu

Tu v spoločnosti Epsilon Retail Media neustále inovujeme a prinášame nové produkty a funkcie. Zmeny v našich API sú preto nevyhnutné. Aby sme našim používateľom pomohli plánovať zmeny, riadime sa pravidlami ukončenia podpory v prípadoch, keď je k dispozícii lepšia verzia alebo sa funkcii blíži či končí podpora.

Obdobie ukončovania podpory verzie sa začína dňom oznámenia o ukončení podpory. Verzie označené na ukončenie podpory budú naďalej k dispozícii počas 3-mesačného obdobia ukončovania podpory. Po uplynutí tohto obdobia sa očakáva vyradenie verzie z prevádzky a spoločnosť Epsilon Retail Media už nemôže zaručiť, že bude od dátumu odstavenia (sunset date) k dispozícii.

## Pravidlá uplatňované pri ukončovaní podpory pre naše API

1. Kritické zmeny (breaking changes), ako je odstránenie prvkov API, sa zavádzajú len zvýšením verzie API.
   * Po pridaní prvku API do určitej verzie ho už z danej verzie nie je možné odstrániť ani výrazne zmeniť jeho správanie
2. Objekty API musia byť schopné obojsmerného prenosu (round-trip) medzi verziami API v danom vydaní s minimálnou alebo žiadnou stratou informácií, s výnimkou celých zdrojov REST, ktoré v niektorých verziách neexistujú.
   * Príklad: objekt možno zapísať ako v1, potom ho načítať späť ako v2 a previesť na v1, pričom výsledný zdroj v1 bude identický s originálom. Reprezentácia vo v2 sa môže od v1 líšiť, ale systém vie, ako medzi nimi prevádzať v oboch smeroch. Okrem toho akékoľvek nové pole pridané vo v2 musí byť schopné obojsmerného prenosu do v1 a späť, čo znamená, že v1 možno bude musieť pridať ekvivalentné pole, mapovať na ekvivalentné pole alebo ho reprezentovať ako anotáciu.
   * Pri významných zmenách produktových funkcií vynaložíme maximálne úsilie na navrhnutie našich API tak, aby boli spätne kompatibilné, ale môžu nastať výnimočné okolnosti, kedy to nemusí byť možné. Tieto výnimky prediskutujeme s našimi partnermi.
3. Verzia API nesmie byť označená na ukončenie podpory v prospech menej stabilnej verzie API.
   * Verzia API pre všeobecnú dostupnosť (GA) môže nahradiť menej stabilné verzie Alpha a Beta
   * Verzie Beta môžu nahradiť skoršie verzie Beta alebo Alpha, ale nesmú sa použiť na nahradenie verzie GA API
   * Verzie Alpha môžu nahradiť skoršie verzie Alpha, ale nesmú sa použiť na nahradenie verzie Beta alebo GA
4. Verzie API označené na ukončenie podpory budú podporované až 3 mesiace od dátumu oznámenia. Oznámime, kedy podpora a dostupnosť danej verzie skončí. Podpora verzií Alpha a Beta môže byť ukončená skôr, keď sa zavedie preferovaná verzia GA API.

* Nové verzie API budú zavedené len ako súčasť vydania, ktoré podporuje novú verziu aj predchádzajúcu verziu
* To poskytuje používateľom čas na migráciu na najnovšiu verziu alebo na návrat k predchádzajúcej verzii v prípade potreby počas obdobia, kým predchádzajúca verzia prestane byť k dispozícii a bude vyradená z prevádzky

5. Volanie vyradenej verzie môže viesť k nepredvídateľnému správaniu alebo neplatnej odpovedi.

## Výnimky

Pravidlá nemôžu pokryť každú možnú situáciu. Toto je živý dokument a postupom času sa bude vyvíjať. V situáciách, ktoré presne nezapadajú do týchto pravidiel, alebo pre ktoré sa tieto pravidlá stanú vážnou prekážkou, prediskutujte daný problém s tímom v spoločnosti <support@citrusad.com> aby ste našli najlepšie riešenia pre tieto konkrétne prípady. Epsilon Retail Media sa zaväzuje poskytovať stabilnú integráciu, ktorá v čo najväčšej miere nenaruší prácu našich používateľov. Výnimky budú vždy oznámené vo všetkých príslušných poznámkach k vydaniu.


---

# 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/sk/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.
