> 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/integration/sk/data-api/api-overview.md). # Prehľad API ## Ako funguje Epsilon Retail Media ? API je organizované okolo architektúry REST. API má predvídateľné adresy URL orientované na zdroje a používa kódy odpovedí HTTP na indikáciu chýb API. API využíva vstavané funkcie HTTP vrátane overenia HTTP a slovies HTTP, ktorým rozumejú bežne dostupné klienty HTTP. Overenie v API sa spravuje pomocou kľúčov API. Kľúče API sa používajú počas komunikácie medzi vaším backendom a API. Integration API podporuje nahrávanie produktov, katalógov, zákazníkov a údajov o objednávkach, ktoré sa používajú na generovanie reklám. Integration API môžete použiť na vyžiadanie reklám a podávanie správ o interakciách s týmito reklamami. ## Integračné koncové body Epsilon Retail Media používa rôzne koncové body na synchronizáciu údajov a generovanie reklám. Stručný prehľad je uvedený nižšie: | Koncový bod | Použitie | Popis | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `catalogs` | [Syncing catalog via API](/retail-media-interface/integration/sk/data-api/catalog-products-2/syncing-catalog-via-api.md) | Používa sa na vytváranie katalógov prostredníctvom API. V prípade menných priestorov pre jeden katalóg je to niečo, čo pre vás môže zorganizovať váš Technical Account Manager. | | `catalog-products` | [Syncing products via API](/retail-media-interface/integration/sk/data-api/catalog-products-2/syncing-products-via-api.md) | Používa sa na vytváranie a aktualizáciu údajov o produktoch v rámci katalógu. | | `customers` | [Syncing customer data via API](/retail-media-interface/integration/sk/data-api/customer-data/syncing-customer-data-via-api-1.md) | Používa sa na vytváranie a aktualizáciu údajov o zákazníkoch v rámci katalógu. | | `orders` | [Syncing order data via API](/retail-media-interface/integration/sk/data-api/order-data-1/syncing-order-data-via-api.md) | Používa sa na odosielanie údajov o objednávkach. | | `/resource/` | [Reporting impressions & clicks](/retail-media-interface/integration/sk/data-api/api-overview/reporting-impressions-clicks.md) [Syncing order data via API](/retail-media-interface/integration/sk/data-api/order-data-1/syncing-order-data-via-api.md) | Používa sa na hlásenie kliknutí a zobrazení, ako aj objednávok pri hlásení prostredníctvom front-endu. | | `/ads/generate` | Generovanie reklám | Používa sa na generovanie produktových reklám a bannerových reklám. | | `/ads/bannerx` | Generovanie reklám | Používa sa na generovanie bannerových x reklám. | {% hint style="info" %} Na synchronizáciu katalógu, produktov, zákazníkov a objednávok nemusíte používať koncové body. Epsilon Retail Media podporuje synchronizáciu údajov prostredníctvom súboru, čo môže vyhovovať vašim požiadavkám. {% endhint %} ## Typ obsahu a užitočné zaťaženie Užitočné zaťaženie údajov je vo formáte JSON. `Content-Type` pre tieto koncové body je `application/json`, ktorý by mal byť odoslaný ako hlavička vo vašich požiadavkách nasledovne: ``` -H "Content-Type: application/json" \ ``` ## Overovanie požiadaviek ### Základné overenie Všetky integračné zdroje používajú základné overenie, ktoré by sa malo odoslať ako hlavička s vaším kľúčom API nasledovne: ``` -H "Authorization: Basic 4ww25f70-b52s-40de-8f29-07b139b5cdc8" \ ``` K vášmu kľúču API je možné pristupovať v sekcii Integračné nastavenia tímu predajcu. Budete potrebovať iba tajný kľúč API. ### Overenie OAuth2.0 Epsilon Retail MediaKoncový bod na generovanie reklám je navyše kompatibilný s OAuth2.0. Pozrite si [Overenie OAuth 2.0](/retail-media-interface/integration/sk/data-api/api-overview/oauth-20-authentication.md) kde nájdete ďalšie informácie. ## Základné adresy URL Epsilon Retail Media používa rôzne základné adresy URL pre pracovné a produkčné prostredie. {% hint style="info" %} Ak chcete získať pracovnú základnú adresu URL, kontaktujte Epsilon Retail MediaPo dokončení integrácie vám poskytneme produkčné základné adresy URL. {% endhint %} --- # 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/integration/sk/data-api/api-overview.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.