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

# Storefront API Optionen

> Werte von Template-Optionen über die Storefront-API auslesen – global oder pro Konfigurationsknoten.

Die Optionen-API liefert die Werte von [Template-Optionen](/frontend/referenz/optionen) über die Storefront-API, analog zum Template-Modul [\$wsOptions](/frontend/referenz/module/wsoptions). So lassen sich im Template definierte und im Admin-Interface gepflegte Optionswerte auch aus einem externen Frontend auslesen.

<Note>
  Die Optionen müssen weiterhin **im Template definiert** werden (siehe [Optionen](/frontend/referenz/optionen)). Die Storefront-API liest die Werte nur aus und ersetzt die Definition nicht.
</Note>

***

## Unterstützte Methoden

Angabe aller unterstützten Methoden.

| **Befehl**                          | **Endpunkte** | **GET**               | **PUT**             | **POST**            | **DELETE**          |
| ----------------------------------- | ------------- | --------------------- | ------------------- | ------------------- | ------------------- |
| Wert einer Template-Option abfragen | `options/get` | <Icon icon="check" /> | <Icon icon="ban" /> | <Icon icon="ban" /> | <Icon icon="ban" /> |

## Methoden für Optionen

Mit dieser Methode wird der Wert einer einzelnen Template-Option bereitgestellt - sowohl für globale Optionen als auch für Optionen, die mit `attachTo` an einen Konfigurationsknoten gebunden sind.

### GET options/get

Liefert den Wert einer Template-Option, analog zu [`$wsOptions.get(name, nodeId)`](/frontend/referenz/module/wsoptions). Der Parameter `nodeId` ist optional und wird für Optionen angegeben, die an einen Konfigurationsknoten gebunden sind.

**Beispiel-Aufruf**, der den Wert einer an eine Zahlungsart gebundenen Option ausliest:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
GET https://<ihr-shop>.de/api/v1/options/get?name=showPaymentIconInFooter&nodeId=payment.payment.bill
```

#### Parameterübersicht

| **Parameter** | **Typ** | **Beschreibung**                                                                                             |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| `name`        | string  | Pflicht. Name der Option, wie im Template definiert.                                                         |
| `nodeId`      | string  | Optional. ID des Konfigurationsknotens bei `attachTo`-Optionen. Ohne Angabe wird der globale Wert geliefert. |

#### Beispiel-Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "name": "showPaymentIconInFooter",
  "nodeId": "payment.payment.bill",
  "value": true
}
```

Wurde im Request kein `nodeId` übergeben, entfällt das Feld `nodeId` in der Antwort. Der Typ von `value` entspricht dem Typ der Option (z. B. `bool`, `string`, `int`).

#### Statuscodes

Existiert keine Option mit dem angefragten `name`, antwortet der Endpunkt mit `404 Not Found`.

***

## Weiterführende Links

* [Optionen](/frontend/referenz/optionen) – Template-Optionen definieren.
* [\$wsOptions](/frontend/referenz/module/wsoptions) – dieselben Werte im Template auslesen.