Das Storefront API Session-Handling stellt Funktionen bereit, um Sessions in der Storefront zu erstellen und zu verwalten. Damit lassen sich Benutzerzustände (z. B. anonymer Besuch oder eingeloggter Kunde) sowie sessiongebundene Daten wie Warenkorb und Merkliste konsistent über mehrere Requests hinweg nutzen. Die Session ist ein Bestandteil des Shops und zwingend erforderlich. Weiteren Informationen dazu finden Sie hier.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.
Unterstützte Methoden
Angabe aller unterstützten Methoden.| Befehl | Endpunkte | GET | POST | PUT | DELETE |
|---|---|---|---|---|---|
| Session erstellen | session/create | ||||
| Link zu einer Template-Seite erstellen. | session/prepareRedirect |
Methoden für das Session-Handling
Diese Methoden kümmern sich um das Session-Handling zwischen API und Storefront: Zunächst werden neue Session-IDs als technische Grundlage für alle weiteren API-Aufrufe erzeugt. Bei Bedarf werden vollständige Weiterleitungslinks zu Template-Seiten (z. B. Checkout) inklusive Übergabe der aktuellen Session aufgebaut. Über optionale Parameter lassen sich Zielseiten gezielt steuern (z. B. ein bestimmter Checkout-Schritt oder Hervorhebungen), während die eigentliche Session-ID sicher im Link eingebettet wird.POST session/create
Folgender Aufruf erstellt eine Session-ID.Mehr Infos dazu: Storefront API Basics
Beispiel-Response
POST session/prepareRedirect
Folgender Aufruf erzeugt einen vollständigen Link zu einer Template-Seite (z. B. „checkout.htm”) und übernimmt die aktuelle Session in die Storefront. Optional können Zusatzparameter übergeben werden, die das Ziel-Template ausliest (z. B. um direkt einen bestimmten Checkout-Schritt zu öffnen). Die Verwendung dieser Methode ist sinnvoll, wenn dein Shop gemischt aufgebaut ist, d. h., wenn einige Teile mit dem WEBSALE-Template Theme und andere Teile mit der Storefront-API erstellt wurden. Der Endpunkt stellt sicher, dass beide Teile dieselbe Session verwenden. Beispiel-Request, der einen vollständigen Link zur Template-Seitecheckout erstellt und dabei die aktuelle Session mitnimmt
Parameterübersicht
| Parameter | Typ | Beschreibung |
|---|---|---|
x-session | string | Pflichtfeld ID der aktuellen Session. Mehr Informationen dazu: Storefront API Basics |
viewIdentifier | string | Pflichtfeld Die ID, die in storefrontApi.redirects konfiguriert wird. Mehr dazu: storefrontApi - Storefront-API |
parameters | object | Optionale Werte, die an die Zielseite übergeben werden und dort z.B. über $wsViews.storefrontApiLinkParameters verfügbar sind. Beispiel: { "viewIdentifier": "checkout", "params": { "step": "address", "highlight": "shipping" } } |
Beispiel-Response
Fehlercodes
| Code | Beschreibung |
|---|---|
redirectNotFound | Kein Konfigurationseintrag zum angegebene viewIdentifier gefunden. |
redisServicePoolInaccessible | Internes Problem. Bitte wenden dich an den Websale-Support. |
redisServiceNotFound | Internes Problem. Bitte wende dich an den Websale-Support. |