> 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/es/data-api/api-overview.md).

# Descripción general de la API

## ¿Cómo funciona Epsilon Retail Media ?

La API está organizada en torno a REST. La API tiene URL predecibles y orientadas a recursos, y utiliza códigos de respuesta HTTP para indicar errores de la API. La API utiliza funciones HTTP integradas, incluidas la autenticación HTTP y los verbos HTTP, que son comprendidos por clientes HTTP estándar.

La autenticación en la API se gestiona mediante el uso de claves API. Las claves API se utilizan durante la comunicación entre su backend y la API.

La API de integración admite la carga de productos, catálogos, clientes y datos de pedidos, que se utilizan para generar anuncios. Puede utilizar la API de integración para solicitar anuncios e informar sobre las interacciones con esos anuncios.

## Puntos de extremo de integración

Epsilon Retail Media utiliza varios puntos de extremo para sincronizar datos y generar anuncios. A continuación se proporciona un breve resumen:

| Punto de extremo   | Uso                                                                                                                                                                                                                                                                               | Descripción                                                                                                                                                              |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `catalogs`         | [Sincronización del catálogo mediante API](/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-catalog-via-api.md)                                                                                                                                         | Se utiliza para crear catálogos a través de la API. Para espacios de nombres de catálogo único, esto es algo que su Technical Account Manager puede organizar por usted. |
| `catalog-products` | [Sincronización de productos mediante API](/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-products-via-api.md)                                                                                                                                        | Se utiliza para crear y actualizar datos de productos dentro de un catálogo.                                                                                             |
| `customers`        | [Sincronización de datos de clientes mediante API](/retail-media-interface/integration/es/data-api/customer-data/syncing-customer-data-via-api-1.md)                                                                                                                              | Se utiliza para crear y actualizar datos de clientes dentro de un catálogo.                                                                                              |
| `orders`           | [Sincronización de datos de pedidos mediante API](/retail-media-interface/integration/es/data-api/order-data-1/syncing-order-data-via-api.md)                                                                                                                                     | Se utiliza para enviar datos de pedidos.                                                                                                                                 |
| `/resource/`       | [Notificación de impresiones y clics](/retail-media-interface/integration/es/data-api/api-overview/reporting-impressions-clicks.md) [Sincronización de datos de pedidos mediante API](/retail-media-interface/integration/es/data-api/order-data-1/syncing-order-data-via-api.md) | Se utiliza para informar sobre clics e impresiones, así como sobre pedidos si se informa a través del front-end.                                                         |
| `/ads/generate`    | Generación de anuncios                                                                                                                                                                                                                                                            | Se utiliza para generar anuncios de productos y anuncios de banner.                                                                                                      |
| `/ads/bannerx`     | Generación de anuncios                                                                                                                                                                                                                                                            | Se utiliza para generar anuncios de banner x.                                                                                                                            |

{% hint style="info" %}
No es necesario utilizar puntos de extremo para la sincronización de catálogos, productos, clientes y pedidos. Epsilon Retail Media admite la sincronización de datos mediante archivos, lo que puede adaptarse a sus requisitos.
{% endhint %}

## Tipo de contenido y carga útil

La carga útil de datos está en formato JSON. El `Content-Type` para estos puntos de extremo es `application/json`, que debe pasarse como un encabezado en sus solicitudes de la siguiente manera:

```
-H "Content-Type: application/json" \
```

## Autenticación de solicitudes

### Autenticación básica

Todos los recursos de integración utilizan autenticación básica, la cual debe pasarse como un encabezado con su clave API de la siguiente manera:

```
-H "Authorization: Basic 4ww25f70-b52s-40de-8f29-07b139b5cdc8" \
```

Puede acceder a su clave API en la sección Configuración de integración del equipo del minorista. Solo necesitará la clave API secreta.

### Autenticación OAuth2.0

Epsilon Retail MediaEl punto de extremo de generación de anuncios de es además compatible con OAuth2.0. Revise [Autenticación OAuth 2.0](/retail-media-interface/integration/es/data-api/api-overview/oauth-20-authentication.md) para obtener más información.

## URL base

Epsilon Retail Media utiliza diferentes URL base para los entornos de prueba (staging) y producción.

{% hint style="info" %}
Para recibir su URL base de prueba, póngase en contacto con Epsilon Retail MediaUna vez que su integración esté en marcha, le proporcionaremos las URL base de producción.
{% 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/es/data-api/api-overview.md?ask=<question>&goal=<endgoal>
```

`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.
