> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sitzung initialisieren

> Initialisieren Sie eine Product Recommendation API-Sitzung, um eine Device-ID und Session-ID zu erhalten, bevor Sie andere Empfehlungs-Endpoints aufrufen.

Bevor Sie eine andere API-Methode in der Product Recommendation API verwenden, rufen Sie die `init`-API auf. Der Initialisierungsprozess akzeptiert den aktuellen Benutzeridentifikator und fordert die Projekteinstellungen sowie die Benutzereinstellungen an.

## HTTP-Anfrage

```html theme={null}
GET https://api.products.kameleoon.com/init
```

## Wann initialisieren

Je nach Plattform gibt es unterschiedliche Anforderungen, wann Sie `init` ausführen müssen:

* **cURL**: Initialisieren Sie bei jedem Rendern der Seite.
* **Web**: Initialisieren Sie bei jedem Öffnen der Seite (einschließlich Single-Page-Anwendungen).
* **iOS** oder **Android**: Initialisieren Sie bei jedem Start der Anwendung.

Beim ersten Start auf einem neuen Gerät fehlt ein Gerätekennzeichner. Rufen Sie die Methode `init` ohne Device-ID auf, um eine zu generieren. Für die Backend-Empfehlungslogik mit Kameleoon Web Experimentation rufen Sie diese API auf und speichern Sie die IDs im Cookie `KameleoonProducts_session_code` für `sid` und `KameleoonProducts_device_id` für `did`.

## Abfrageparameter

| Parameter | Typ    | Erforderlich | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------- | ------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `shop_id` | String | True         | Ihr Store Key. Sie finden ihn in **Recommendations** > **Settings** > **Store settings** in der Kameleoon App. Sie können sich auch an Ihren Customer Success Manager wenden, um den Schlüssel zu erhalten                                                                                                                                                                                                                                              |
| `did`     | String | False        | Eine Device-ID. Wenn bereits eine Device-ID vorhanden ist, geben Sie diese hier an. Wenn Sie keine `did` angeben, generiert die API eine neue in der Kameleoon-Datenbank. Verwenden Sie diese generierte ID als Device-ID für alle zukünftigen Anfragen                                                                                                                                                                                                 |
| `sid`     | String | True\*       | Eine Session-ID ist ein temporärer Identifikator, der dem Benutzer für die aktuelle Sitzung zugewiesen wird. Sie muss eine eindeutige Zeichenfolge sein und wird bei jeder neuen Sitzung neu generiert. Geben Sie für die anfängliche init-Anfrage keine `sid` an. Die `sid` wird von Kameleoon generiert und in der API-Antwort zurückgegeben. Wenn in der Anfrage eine `sid` angegeben wird, die nicht im System vorhanden ist, tritt ein Fehler auf. |

<Note>
  Obwohl der Parameter `sid` erforderlich ist, fügen Sie ihn bei der ersten Initialisierung nicht hinzu, da das System ihn generiert und in der Antwort zurückgibt (als `seance`).

  Sobald die `sid` generiert ist, verwenden Sie die vom System generierte `sid` für Anfragen innerhalb der aktuellen Sitzung.
</Note>