> 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/hu/deprecation-schedule-policy/api-deprecation-policy.md). # API-kivezetési szabályzat ## Miért vezetünk ki funkciókat Itt a(z) Epsilon Retail Media folyamatosan fejlesztünk, és új termékeket, valamint funkciókat vezetünk be. Ennek következtében az API-jaink módosításai elkerülhetetlenek. Annak érdekében, hogy segítsük felhasználóinkat a változások megtervezésében, kivezetési szabályzatot követünk abban az esetben, ha egy jobb verzió válik elérhetővé, vagy ha egy funkció a támogatási időszaka végéhez közeledik vagy eléri azt. Egy verzió kivezetési időszaka a kivezetés bejelentésének napján kezdődik. A kivezetésre kijelölt verziók a 3 hónapos kivezetési időszak alatt továbbra is elérhetők maradnak. Amint a kivezetési időszak letelt, a verzió várhatóan leállításra kerül, és a(z) Epsilon Retail Media már nem tudja garantálni, hogy az elérhető lesz a kivezetés végleges dátumától (sunset date). ## Szigorú kivezetési szabályok az API-jainkhoz 1. A működést megszakító módosítások, mint például az eltávolított API-elemek, csak az API verziószámának növelésével kerülnek bevezetésre. * Miután egy API-elem hozzáadásra került egy adott verzióhoz, nem távolítható el abból a verzióból, és a viselkedése sem módosítható jelentősen 2. Az API-objektumoknak képesnek kell lenniük oda-vissza konvertálódni (round-trip) az adott kiadás API-verziói között minimális vagy nulla információveszteséggel, kivéve azokat az teljes REST-erőforrásokat, amelyek egyes verziókban nem léteznek. * Például egy objektum kiírható v1 verzióként, majd visszaolvasható v2 verzióként és konvertálható v1-re, és az eredményül kapott v1 erőforrás megegyezik az eredetivel. A v2-ben lévő megjelentetés eltérhet a v1-től, de a rendszer tudja, hogyan kell átalakítani közöttük mindkét irányban. Ezenkívül a v2-ben hozzáadott minden új mezőnek képesnek kell lennie oda-vissza konvertálódni a v1-re és vissza, ami azt jelenti, hogy a v1-nek lehet, hogy hozzá kell adnia egy egyenértékű mezőt, le kell képeznie egy egyenértékű mezőre, vagy annotációként kell képviselnie azt. * A termék funkcióinak jelentős változásai esetén minden erőfeszítést megteszünk annak érdekében, hogy az API-jainkat úgy tervezzük meg, hogy visszafelé kompatibilisek legyenek, de előfordulhatnak olyan kivételes körülmények, amikor ez nem lehetséges. Ezeket a kivételeket megbeszéljük a partnereinkkel. 3. Egy API-verzió nem vezethető ki egy kevésbé stabil API-verzió javára. * Egy általánosan elérhető (General Availability – GA) API-verzió felválthatja a kevésbé stabil Alpha és Beta verziókat * A Beta verziók felválthatják a korábbi Beta vagy Alpha verziókat, de nem használhatók egy GA API-verzió felváltására * Az Alpha verziók felválthatják a korábbi Alpha verziókat, de nem használhatók egy Beta vagy a GA verzió felváltására 4. A kivezetésre kijelölt API-verziók az értesítés dátumától számított legfeljebb 3 hónapig támogatottak. Be fogjuk jelenteni, mikor ér véget a verzió támogatottsága és elérhetősége. Az Alpha és Beta verziók kivezetése korábban is megtörténhet, amint egy előnyben részesített GA API-verzió bevezetésre kerül. * Új API-verziók csak olyan kiadás részeként kerülnek bevezetésre, amely mind az új verziót, mind az előző verziót támogatja * Ez időt biztosít a felhasználók számára, hogy áttérjenek a legújabb verzióra, vagy szükség esetén visszálljanak arra az időszakra, amíg a korábbi verzió már nem érhető el és leállításra került. 5. Egy leállított verzió hívása kiszámíthatatlan viselkedést vagy érvénytelen választ eredményezhet. ## Kivételek Egy szabályzat nem terjedhet ki minden lehetséges helyzetre. Ez egy élő dokumentum, és az idő múlásával mindig fejlődni fog. Ahol olyan helyzetek adódnak, amelyek nem illeszkednek pontosan ebbe a szabályzatba, vagy amelyeknél ez a szabályzat komoly akadályt jelent, vitassa meg a kihívást a csapatunkkal a(z) helyen, hogy megtalálja a legjobb megoldásokat azokra a specifikus esetekre. Epsilon Retail Media elkötelezett amellett, hogy olyan stabil integrációt biztosítson, amely a lehető legkevésbé zavarja felhasználóinkat. A kivételeket mindig bejelentjük az összes vonatkozó kiadási megjegyzésben (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/hu/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.