> 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/partner/de/partner-api-authentication/user-key-authentication.md).

# Benutzerschlüssel-Token

## Tokens anfordern

Um Ihr erforderliches Zugriffstoken zu erhalten, senden Sie eine Anfrage an den `/user-key-token` -Endpunkt, indem Sie die folgenden Parameter unter Verwendung des `application/x-www-form-urlencoded` -Formats mit einer Zeichenkodierung von UTF-8 im HTTP-Anfragekörper hinzufügen.

```http
POST https://auth.<env>.citrusad.com/v2/user-key-token
Content-Type: application/x-www-form-urlencoded
user_key=<USER_KEY>
```

Sie erhalten eine Antwort mit einem `accessToken`,`expiresIn`, und `tokenType`.

```json
{
    "accessToken": "ACCESS_TOKEN",
    "expiresIn": 84000,
    "tokenType": "Bearer"
}
```

{% hint style="info" %}
Ihr **access**-Token wird verwendet, um auf die Epsilon Retail Media -API zuzugreifen.
{% endhint %}

## Refresh-Token

Wenn Ihr Zugriffstoken abläuft, erhalten Sie von der Kampagnen-API einen Fehler wegen eines ungültigen Tokens. In diesem Fall senden Sie eine Anfrage an den `/token` -Endpunkt mit Ihrem Refresh-Token, wie im folgenden Diagramm dargestellt:

<figure><img src="/files/Bk8JG8gD5JTHFwzjuJ8C" alt="Authentication refresh flow.png" width="100%"><figcaption></figcaption></figure>

In der Regel benötigt ein Benutzer nur dann ein neues Zugriffstoken, wenn das vorherige abläuft oder wenn er Zugriff auf Ressourcen erhält oder verliert, die an seine Claims gebunden sind. Es ist eine schlechte Praxis, den Endpunkt aufzurufen, um für jede Anfrage an unsere API ein neues Zugriffstoken zu erhalten.


---

# 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/partner/de/partner-api-authentication/user-key-authentication.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.