Shopware

Shopware Store API

Die Shopware Store API ist die kundenseitige Schnittstelle von Shopware 6, über die ein Frontend auf einen Sales Channel zugreift. Sie liefert Storefront-Daten wie Produkte, Kategorien und Preise und steuert Warenkorb, Checkout und Kundenkonto. Die Store API ist RESTful aufgebaut, gibt Daten im JSON-Format aus und ist die technische Basis für Headless- und Composable-Commerce-Aufbauten mit Shopware.

Die Store API bildet die Prozesse ab, die sonst die Standard-Storefront von Shopware auslöst: Produkte suchen und filtern, Artikel in den Warenkorb legen, den Checkout durchlaufen und ein Kundenkonto verwalten. Jede Anfrage läuft im Kontext eines konkreten Sales Channels und wird über einen Access-Key (Header sw-access-key) diesem Verkaufskanal zugeordnet.

Damit ist die Store API die eine Hälfte des zweigeteilten Shopware-API-Modells. Ihre Gegenstelle, die Admin API, ist für Verwaltung und Integration zuständig. Wer den Gesamtüberblick sucht, findet ihn im Eintrag Shopware API, der beide Schnittstellen gemeinsam einordnet. Dieser Eintrag vertieft ausschließlich die Store API.

Kriterium	Shopware Store API	Shopware Admin API
Perspektive	Kundenseitig (Frontend, Sales Channel)	Verwaltend (Backend, Integration)
Typische Nutzung	Produkte anzeigen, Warenkorb, Checkout, Kundenkonto	Produkte, Bestellungen, Kunden pflegen (CRUD)
Aufrufer	Frontend, App, Headless-Storefront	ERP, PIM, Middleware, Server-Prozesse
Authentifizierung	Access-Key je Sales Channel (sw-access-key)	OAuth 2.0 (Integration oder Nutzer)
Datenumfang	Nur freigegebene, kundenrelevante Daten	Voller Zugriff auf Backend-Entitäten

Stand: August 2026. Angaben zur Shopware 6 Store API und Admin API auf Basis der offiziellen Entwicklerdokumentation (developer.shopware.com).

Datenfluss der Shopware Store API

Das Frontend sendet Anfragen mit einem Sales-Channel-Access-Key an die Store API. Diese greift auf den Shopware-Core zu und liefert kundenrelevante Daten im JSON-Format zurück. Die Darstellung ist schematisch vereinfacht.

Wofür wird die Shopware Store API genutzt?

Die Store API deckt alle Interaktionen ab, die im klassischen Onlineshop zwischen Besucher und Storefront stattfinden. Sie ist die Schnittstelle, an der ein eigenes oder entkoppeltes Frontend andockt. Typische Aufgaben:

Produkte, Kategorien, Preise und Verfügbarkeiten für die Anzeige im Frontend abrufen.
Suche, Filter und Aggregationen (Listing) über die Store-API-Endpunkte bedienen.
Warenkorb aufbauen, ändern und den Checkout inklusive Zahlart und Versand durchlaufen.
Kundenkonto verwalten: Registrierung, Login, Adressen und Bestellhistorie.

Jede dieser Funktionen ist an einen Sales Channel gebunden. So kann derselbe Shopware-Core mehrere Verkaufskanäle (etwa Web, App, B2B-Portal) mit jeweils eigener Konfiguration über dieselbe Store API bedienen.

Einordnung

Die Store API ist der Hebel, wenn ein Kunde von der Standard-Storefront weg und in Richtung Headless will, ohne den Shopware-Core aufzugeben. Der Reiz liegt darin, dass Warenkorb- und Checkout-Logik im Core bleiben und nicht im Frontend nachgebaut werden. Der Fehler, den wir am häufigsten korrigieren, ist die Verwechslung mit der Admin API: Wer Produktdaten pflegen oder ein ERP anbinden will, ist bei der Store API falsch.

Philipp Foreman, Geschäftsführer onacy GmbH

Store API und Headless Commerce

Headless bedeutet, dass die Präsentationsschicht vom Shop-Backend entkoppelt ist. Genau hier ist die Store API die tragende Schnittstelle: Sie stellt die Verkaufslogik als Service bereit, den ein beliebiges Frontend konsumiert. Shopware bietet mit den Composable Frontends eine eigene, auf der Store API aufsetzende Headless-Umsetzung. Wer die grundsätzliche Zweiteilung der Schnittstellen noch einmal von oben sehen möchte, findet sie im Überblick Shopware API.

Bei onacy als Shopware-Partner planen wir Store-API-Projekte so, dass Sales-Channel-Struktur, Caching und Frontend-Anbindung von Anfang an zusammenpassen. Fehlt diese Planung, entstehen später doppelte Logik und Performance-Probleme.

Häufige Fragen zur Shopware Store API

Was ist die Shopware Store API?

Die Shopware Store API ist die kundenseitige Schnittstelle von Shopware 6. Über sie greift ein Frontend im Kontext eines Sales Channels auf Storefront-Daten wie Produkte und Preise zu und steuert Warenkorb, Checkout und Kundenkonto. Sie ist RESTful aufgebaut, liefert JSON und bildet die Basis für Headless- und Composable-Commerce-Aufbauten mit Shopware.

Was ist der Unterschied zwischen Store API und Admin API?

Die Store API ist kundenseitig und bedient das Frontend eines Sales Channels mit Produktanzeige, Warenkorb und Checkout. Die Admin API ist verwaltend und dient der Integration, etwa dem Pflegen von Produkten, Bestellungen und Kunden aus ERP oder PIM. Store API nutzt einen Sales-Channel-Access-Key, die Admin API OAuth 2.0. Beide sind RESTful und liefern JSON.

Wie authentifiziert sich ein Frontend an der Store API?

Ein Frontend authentifiziert sich über einen Access-Key, der einem Sales Channel zugeordnet ist. Der Schlüssel wird als Header (sw-access-key) bei jeder Anfrage mitgesendet und ordnet den Aufruf dem richtigen Verkaufskanal zu. Für kundenspezifische Aktionen wie den Zugriff auf ein Konto kommt zusätzlich ein Kontext-Token hinzu. Die Store API gibt nur kundenrelevante Daten frei.

Brauche ich die Store API für Headless Commerce mit Shopware?

Ja. Bei einem Headless-Aufbau ist die Store API die Schnittstelle, über die das entkoppelte Frontend auf die Verkaufslogik von Shopware zugreift. Warenkorb, Checkout und Kundenkonto bleiben im Shopware-Core, das Frontend konsumiert sie als Service. Shopware liefert mit den Composable Frontends eine eigene, auf der Store API aufbauende Headless-Umsetzung.

Headless mit Shopware sauber aufsetzen

Die Store API ist mächtig, aber nur so gut wie die Sales-Channel-Struktur dahinter. Im Erstgespräch klären wir, ob ein Headless- oder Composable-Aufbau für Ihren Shop trägt und wie Frontend, Caching und Core zusammenspielen.

Shopware-Erstgespräch vereinbaren

Mehr Kontext: Shopware-Leistungen und Integrationen und Schnittstellen