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
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
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
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.
War das hilfreich?