> 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/fr/data-api/api-overview.md). # Présentation de l'API ## Comment fonctionne Epsilon Retail Media ? L'API est organisée autour de REST. L'API possède des URL prévisibles et orientées ressources, et utilise les codes de réponse HTTP pour indiquer les erreurs d'API. L'API utilise des fonctionnalités HTTP intégrées, notamment l'authentification HTTP et les verbes HTTP, qui sont comprises par les clients HTTP prêts à l'emploi. L'authentification auprès de l'API est gérée via l'utilisation de clés d'API. Les clés d'API sont utilisées lors de la communication entre votre backend et l'API. L'API d'intégration prend en charge le téléchargement de données sur les produits, les catalogues, les clients et les commandes, qui sont utilisées pour générer des annonces. Vous pouvez utiliser l'API d'intégration pour demander des annonces et générer des rapports sur les interactions avec ces annonces. ## Points de terminaison d'intégration Epsilon Retail Media utilise différents points de terminaison pour synchroniser les données et générer des annonces. Un bref résumé est fourni ci-dessous : | Point de terminaison | Utilisation | Description | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `catalogs` | [Synchronisation du catalogue via l'API](/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-catalog-via-api.md) | Utilisé pour créer des catalogues via l'API. Pour les espaces de noms de catalogue unique, c'est quelque chose que votre Technical Account Manager peut organiser pour vous. | | `catalog-products` | [Synchronisation des produits via l'API](/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-products-via-api.md) | Utilisé pour créer et mettre à jour les données de produits dans un catalogue. | | `customers` | [Synchronisation des données clients via l'API](/retail-media-interface/integration/fr/data-api/customer-data/syncing-customer-data-via-api-1.md) | Utilisé pour créer et mettre à jour les données clients dans un catalogue. | | `orders` | [Synchronisation des données de commande via l'API](/retail-media-interface/integration/fr/data-api/order-data-1/syncing-order-data-via-api.md) | Utilisé pour envoyer les données de commande. | | `/resource/` | [Rapport sur les impressions et les clics](/retail-media-interface/integration/fr/data-api/api-overview/reporting-impressions-clicks.md) [Synchronisation des données de commande via l'API](/retail-media-interface/integration/fr/data-api/order-data-1/syncing-order-data-via-api.md) | Utilisé pour signaler les clics et les impressions, ainsi que les commandes en cas de suivi via le front-end. | | `/ads/generate` | Générer des annonces | Utilisé pour générer des annonces de produits et des annonces de bannière. | | `/ads/bannerx` | Générer des annonces | Utilisé pour générer des annonces de bannière x. | {% hint style="info" %} Vous n'avez pas besoin d'utiliser les points de terminaison pour la synchronisation des catalogues, des produits, des clients et des commandes. Epsilon Retail Media prend en charge la synchronisation des données via un fichier, ce qui peut convenir à vos besoins. {% endhint %} ## Type de contenu & charge utile La charge utile des données est au format JSON. Le `Content-Type` pour ces points de terminaison est `application/json` , qui doit être transmis sous forme d'en-tête dans vos requêtes comme suit : ``` -H "Content-Type: application/json" \ ``` ## Authentification des requêtes ### Authentification basique Toutes les ressources d'intégration utilisent l'authentification basique, qui doit être transmise sous forme d'en-tête avec votre clé d'API comme suit : ``` -H "Authorization: Basic 4ww25f70-b52s-40de-8f29-07b139b5cdc8" \ ``` Votre clé d'API est accessible dans la section Paramètres d'intégration de l'équipe commerçant. Vous n'aurez besoin que de la clé d'API secrète. ### Authentification OAuth2.0 Epsilon Retail MediaLe point de terminaison de génération d'annonces de est également compatible avec OAuth2.0. Consultez [Authentification OAuth 2.0](/retail-media-interface/integration/fr/data-api/api-overview/oauth-20-authentication.md) pour plus d'informations. ## URL de base Epsilon Retail Media utilise différentes URL de base pour les environnements de staging et de production. {% hint style="info" %} Pour recevoir votre URL de base de staging, veuillez contacter Epsilon Retail Media . Une fois votre intégration en cours, nous vous fournirons les URL de base de production. {% 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/fr/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.