> 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/it/data-api/api-overview.md). # Panoramica API ## Come funziona Epsilon Retail Media l'API? L'API è organizzata attorno al modello REST. L'API presenta URL prevedibili, orientati alle risorse e utilizza i codici di risposta HTTP per indicare gli errori dell'API. L'API utilizza funzionalità HTTP integrate, tra cui l'autenticazione HTTP e i verbi HTTP, compresi dai client HTTP standard. L'autenticazione all'API è gestita tramite l'uso di chiavi API. Le chiavi API vengono utilizzate durante la comunicazione tra il backend e l'API. L'Integration API supporta il caricamento di dati relativi a prodotti, cataloghi, clienti e ordini, utilizzati per generare annunci. È possibile utilizzare l'Integration API per richiedere annunci e generare report sulle interazioni con tali annunci. ## Endpoint di integrazione Epsilon Retail Media utilizza vari endpoint per sincronizzare i dati e generare annunci. Di seguito viene fornito un breve riepilogo: | Endpoint | Uso | Descrizione | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `catalogs` | [Sincronizzazione del catalogo tramite API](/retail-media-interface/integration/it/data-api/catalog-products-2/syncing-catalog-via-api.md) | Utilizzato per creare cataloghi tramite API. Per i namespace di catalogo singolo, questo è un aspetto che il tuo Technical Account Manager può organizzare per te. | | `catalog-products` | [Sincronizzazione dei prodotti tramite API](/retail-media-interface/integration/it/data-api/catalog-products-2/syncing-products-via-api.md) | Utilizzato per creare e aggiornare i dati dei prodotti all'interno di un catalogo. | | `customers` | [Sincronizzazione dei dati dei clienti tramite API](/retail-media-interface/integration/it/data-api/customer-data/syncing-customer-data-via-api-1.md) | Utilizzato per creare e aggiornare i dati dei clienti all'interno di un catalogo. | | `orders` | [Sincronizzazione dei dati degli ordini tramite API](/retail-media-interface/integration/it/data-api/order-data-1/syncing-order-data-via-api.md) | Utilizzato per inviare i dati degli ordini. | | `/resource/` | [Segnalazione di impression e clic](/retail-media-interface/integration/it/data-api/api-overview/reporting-impressions-clicks.md) [Sincronizzazione dei dati degli ordini tramite API](/retail-media-interface/integration/it/data-api/order-data-1/syncing-order-data-via-api.md) | Utilizzato per generare report su clic e impressioni, nonché sugli ordini se i report vengono inviati tramite front-end. | | `/ads/generate` | Generazione di annunci | Utilizzato per generare annunci di prodotti e annunci banner. | | `/ads/bannerx` | Generazione di annunci | Utilizzato per generare annunci banner x. | {% hint style="info" %} Non è necessario utilizzare gli endpoint per la sincronizzazione di catalogo, prodotti, clienti e ordini. Epsilon Retail Media supporta la sincronizzazione dei dati tramite file, che potrebbe essere adatta alle tue esigenze. {% endhint %} ## Tipo di contenuto e payload Il payload dei dati è in formato JSON. Il `Content-Type` per questi endpoint è `application/json`, che deve essere passato come intestazione nelle tue richieste come segue: ``` -H "Content-Type: application/json" \ ``` ## Autenticazione delle richieste ### Autenticazione di base Tutte le risorse di integrazione utilizzano l'autenticazione di base, che deve essere passata come intestazione con la chiave API come segue: ``` -H "Authorization: Basic 4ww25f70-b52s-40de-8f29-07b139b5cdc8" \ ``` È possibile accedere alla chiave API nella sezione Impostazioni di integrazione del team del rivenditore. Avrai bisogno solo della chiave API segreta. ### Autenticazione OAuth2.0 Epsilon Retail MediaL'endpoint di generazione degli annunci è inoltre compatibile con OAuth2.0. Consulta [Autenticazione OAuth 2.0](/retail-media-interface/integration/it/data-api/api-overview/oauth-20-authentication.md) per maggiori informazioni. ## URL di base Epsilon Retail Media utilizza URL di base diversi per gli ambienti di staging e produzione. {% hint style="info" %} Per ricevere il tuo URL di base di staging, contatta Epsilon Retail Media. Una volta avviata l'integrazione, ti forniremo gli URL di base di produzione. {% 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/it/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.