> 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/de/data-api/api-overview.md). # API-Übersicht ## Wie funktioniert Epsilon Retail Media arbeite? Die API ist nach dem REST-Prinzip organisiert. Die API verfügt über vorhersehbare, ressourcenorientierte URLs und verwendet HTTP-Antwortcodes zur Anzeige von API-Fehlern. Die API nutzt integrierte HTTP-Funktionen wie HTTP-Authentifizierung und HTTP-Verben, die von gängigen HTTP-Clients verstanden werden. Die Authentifizierung bei der API wird durch die Verwendung von API-Schlüsseln verwaltet. API-Schlüssel werden bei der Kommunikation zwischen Ihrem Backend und der API verwendet. Die Integration API unterstützt das Hochladen von Produkten, Katalogen, Kunden- und Bestelldaten, die zur Generierung von Anzeigen verwendet werden. Sie können die Integration API verwenden, um Anzeigen anzufordern und über Interaktionen mit diesen Anzeigen zu berichten. ## Integrations-Endpunkte Epsilon Retail Media verwendet verschiedene Endpunkte, um Daten zu synchronisieren und Anzeigen zu generieren. Nachfolgend finden Sie eine kurze Zusammenfassung: | Endpunkt | Verwendung | Beschreibung | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `catalogs` | [Katalog-Synchronisierung über API](/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-catalog-via-api.md) | Wird zum Erstellen von Katalogen über die API verwendet. Für einzelne Katalog-Namespaces kann Ihr Technical Account Manager dies für Sie organisieren. | | `catalog-products` | [Produkt-Synchronisierung über API](/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-products-via-api.md) | Wird zum Erstellen und Aktualisieren von Produktdaten in einem Katalog verwendet. | | `customers` | [Kunden-Datensynchronisierung über API](/retail-media-interface/integration/de/data-api/customer-data/syncing-customer-data-via-api-1.md) | Wird zum Erstellen und Aktualisieren von Kundendaten in einem Katalog verwendet. | | `orders` | [Bestelldaten-Synchronisierung über API](/retail-media-interface/integration/de/data-api/order-data-1/syncing-order-data-via-api.md) | Wird zum Senden von Bestelldaten verwendet. | | `/resource/` | [Berichterstellung für Impressionen und Klicks](/retail-media-interface/integration/de/data-api/api-overview/reporting-impressions-clicks.md) [Bestelldaten-Synchronisierung über API](/retail-media-interface/integration/de/data-api/order-data-1/syncing-order-data-via-api.md) | Wird zur Erfassung von Klicks und Impressionen sowie von Bestellungen verwendet, wenn das Reporting über das Frontend erfolgt. | | `/ads/generate` | Anzeigen generieren | Wird zur Generierung von Produktanzeigen und Banneranzeigen verwendet. | | `/ads/bannerx` | Anzeigen generieren | Wird zur Generierung von Banner-x-Anzeigen verwendet. | {% hint style="info" %} Sie müssen keine Endpunkte für die Synchronisierung von Katalogen, Produkten, Kunden und Bestellungen verwenden. Epsilon Retail Media unterstützt die Datensynchronisierung per Datei, was für Ihre Anforderungen geeignet sein kann. {% endhint %} ## Content-Type und Payload Die Nutzlast (Payload) liegt im JSON-Format vor. Der `Content-Type` für diese Endpunkte ist `application/json`, der wie folgt als Header in Ihren Anfragen übergeben werden sollte: ``` -H "Content-Type: application/json" \ ``` ## Anfragen authentifizieren ### Basic Authentication Alle Integrationsressourcen verwenden Basic Authentication, die wie folgt als Header mit Ihrem API-Schlüssel übergeben werden sollte: ``` -H "Authorization: Basic 4ww25f70-b52s-40de-8f29-07b139b5cdc8" \ ``` Auf Ihren API-Schlüssel können Sie im Bereich Integration Settings des Retailer-Teams zugreifen. Sie benötigen nur den geheimen API-Schlüssel. ### OAuth2.0-Authentifizierung Epsilon Retail MediaDer Ad-Generierungs-Endpunkt von ist zusätzlich mit OAuth2.0 kompatibel. Überprüfen Sie [OAuth 2.0-Authentifizierung](/retail-media-interface/integration/de/data-api/api-overview/oauth-20-authentication.md) für weitere Informationen. ## Basis-URLs Epsilon Retail Media verwendet unterschiedliche Basis-URLs für Staging- und Produktionsumgebungen. {% hint style="info" %} Um Ihre Staging-Basis-URL zu erhalten, wenden Sie sich bitte an Epsilon Retail Media. Sobald Ihre Integration läuft, stellen wir Ihnen die Produktions-Basis-URLs zur Verfügung. {% 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/de/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.