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

# API-översikt

## Hur fungerar Epsilon Retail Media fungera?

API:et är uppbyggt kring REST. API:et har förutsägbara, resurssorterade URL:er och använder HTTP-svarskoder för att indikera API-fel. API:et använder inbyggda HTTP-funktioner inklusive HTTP-autentisering och HTTP-verb, som förstås av vanliga HTTP-klienter.

Autentisering till API:et hanteras med hjälp av API-nycklar. API-nycklar används under kommunikationen mellan din backend och API:et.

Integration API har stöd för uppladdning av produkter, kataloger, kunder och orderdata, vilket används för att generera annonser. Du kan använda Integration API för att begära annonser och rapportera om interaktioner med dessa annonser.

## Integrationsslutpunkter

Epsilon Retail Media använder olika slutpunkter för att synkronisera data och generera annonser. En kort sammanfattning finns nedan:

| Slutpunkt          | Användning                                                                                                                                                                                                                                              | Beskrivning                                                                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `catalogs`         | [Syncing catalog via API](/retail-media-interface/integration/sv/data-api/catalog-products-2/syncing-catalog-via-api.md)                                                                                                                                | Används för att skapa kataloger via API. För namnområden med enstaka kataloger är detta något som din Technical Account Manager kan ordna åt dig. |
| `catalog-products` | [Syncing products via API](/retail-media-interface/integration/sv/data-api/catalog-products-2/syncing-products-via-api.md)                                                                                                                              | Används för att skapa och uppdatera produktdata i en katalog.                                                                                     |
| `customers`        | [Syncing customer data via API](/retail-media-interface/integration/sv/data-api/customer-data/syncing-customer-data-via-api-1.md)                                                                                                                       | Används för att skapa och uppdatera kunddata i en katalog.                                                                                        |
| `orders`           | [Syncing order data via API](/retail-media-interface/integration/sv/data-api/order-data-1/syncing-order-data-via-api.md)                                                                                                                                | Används för att skicka orderdata.                                                                                                                 |
| `/resource/`       | [Reporting impressions & clicks](/retail-media-interface/integration/sv/data-api/api-overview/reporting-impressions-clicks.md) [Syncing order data via API](/retail-media-interface/integration/sv/data-api/order-data-1/syncing-order-data-via-api.md) | Används för att rapportera klick och exponeringar, samt beställningar om du rapporterar via front-end.                                            |
| `/ads/generate`    | Generera annonser                                                                                                                                                                                                                                       | Används för att generera produktannonser och bannerannonser.                                                                                      |
| `/ads/bannerx`     | Generera annonser                                                                                                                                                                                                                                       | Används för att generera banner x-annonser.                                                                                                       |

{% hint style="info" %}
Du behöver inte använda slutpunkter för synkronisering av katalog, produkt, kund och order. Epsilon Retail Media stöder synkronisering av data via fil, vilket kan vara lämpligt för dina krav.
{% endhint %}

## Innehållstyp & nyttolast

Datanyttolasten är i JSON-format. `Content-Type` för dessa slutpunkter är `application/json`, vilket bör skickas som en header i dina begäranden enligt följande:

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

## Autentisera begäranden

### Basic-autentisering

Alla integrationsresurser använder basic-autentisering som ska skickas som en header med din API-nyckel enligt följande:

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

Din API-nyckel hittar du i avsnittet Integrationsinställningar för återförsäljarteamet. Du behöver bara den hemliga API-nyckeln.

### OAuth2.0-autentisering

Epsilon Retail Medias annonsgenereringsslutpunkt är dessutom kompatibel med OAuth2.0. Granska [OAuth 2.0-autentisering](/retail-media-interface/integration/sv/data-api/api-overview/oauth-20-authentication.md) för mer information.

## Bas-URL:er

Epsilon Retail Media använder olika bas-URL:er för staging- och produktionsmiljöer.

{% hint style="info" %}
För att få din bas-URL för staging, vänligen kontakta Epsilon Retail Media. När din integration är igång kommer vi att förse dig med bas-URL:er för produktion.
{% 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/sv/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.
