Store API

PremsManufacturer stellt drei Store-API-Routen bereit, mit denen Hersteller-Daten in Composable Storefronts oder eigenen Frontends abgerufen werden können.

Hersteller-Liste laden

Liefert eine paginierbare Liste der Hersteller, optional gefiltert nach Anfangsbuchstabe oder Suchbegriff.

Endpunkt: POST /store-api/prems-manufacturer/list
Login erforderlich: Nein

Parameter	Typ	Pflicht	Beschreibung
`page`	int	Nein	Seitennummer (ab 1). Standard: 1.
`limit`	int	Nein	Anzahl Hersteller pro Seite. Standard: 24.
`letter`	string	Nein	Anfangsbuchstabe (A–Z) oder „0-9" für numerische Hersteller.
`search`	string	Nein	Suchbegriff im Herstellernamen (Contains-Filter).

Antwort: Liefert eine Hersteller-Collection mit Total-Count und – sofern in der Advanced-Version aktiv – eine Liste der Anfangsbuchstaben mit mindestens einem Hersteller für die A-Z-Navigation.

Fehler:

In der kostenlosen Version werden maximal 5 Hersteller zurückgegeben; die A-Z-Buchstabenliste ist leer.

Hersteller-Detail laden

Liefert die Daten eines einzelnen Herstellers inklusive eines vollwertigen Produkt-Listings.

Endpunkt: POST /store-api/prems-manufacturer/detail/{manufacturerId}
Login erforderlich: Nein

Parameter	Typ	Pflicht	Beschreibung
`manufacturerId`	string	Ja	Hersteller-ID im URL-Pfad.
`order`	string	Nein	Sortierungsschlüssel (siehe `core.listing.defaultSorting`).
`p`	int	Nein	Seitennummer der Produkt-Liste.
`limit`	int	Nein	Anzahl Produkte pro Seite.
`manufacturer-filter`, `rating-filter`, `price-filter`, `shipping-free-filter`, `property-filter`	bool	Nein	Schaltet einzelne Listing-Filter ein/aus (entspricht den Standard-Listing-Filtern).

Antwort: Liefert die Hersteller-Entity sowie das Produkt-Listing inkl. verfügbarer Sortierungen, Aggregationen, gesetzter Filter und aktuellem Filter-State.

Fehler:

404 – Hersteller mit der angegebenen ID existiert nicht.

Hersteller-Suche (Suggest)

Liefert eine reduzierte Hersteller-Liste für die Suchvorschau im Header.

Endpunkt: POST /store-api/prems-manufacturer/suggest
Login erforderlich: Nein

Parameter	Typ	Pflicht	Beschreibung
`search`	string	Nein	Suchbegriff (Contains-Filter über den Herstellernamen).
`limit`	int	Nein	Maximalanzahl Treffer (1–20). Standard: 5.

Antwort: Liefert eine kurze Hersteller-Collection inklusive Logo-Media-Association.

Fehler:

Die Route ist nur in der Advanced-Version verfügbar; die kostenlose Version liefert immer eine leere Collection.