Store API

Das Stock Reminder Plugin stellt zwei Store-API-Endpunkte bereit, die für Headless-Projekte oder individuelle Storefront-Implementierungen genutzt werden können.

Abonnement anlegen

Erstellt ein neues Benachrichtigungs-Abonnement für ein Produkt.

Endpunkt: POST /store-api/prems/stock-reminder/subscribe

Login erforderlich: Nein

Parameter:

Parameter	Typ	Pflicht	Beschreibung
productId	string	Ja	Die UUID des Produkts.
email	string	Ja	Die E-Mail-Adresse des Abonnenten. Muss eine gültige E-Mail-Adresse sein.
quantity	int	Nein	Die gewünschte Bestellmenge. Standardwert: 1. Wird ignoriert, wenn die Mengenauswahl in der Konfiguration ausgeblendet ist – in diesem Fall wird die Mindestbestellmenge des Produkts verwendet.

Antwort: 204 No Content bei Erfolg.

Fehler:

• 403 Forbidden – Das Plugin ist für den Verkaufskanal nicht aktiv oder das Subscription-Limit der kostenlosen Version wurde erreicht.

• 400 Bad Request – Ungültige Eingabedaten (fehlende Produkt-ID, ungültige E-Mail).

Abonnement bestätigen

Bestätigt ein Abonnement über den Double-Opt-In-Hash.

Endpunkt: POST /store-api/prems/stock-reminder/confirm/{hash}

Login erforderlich: Nein

Parameter:

Parameter	Typ	Pflicht	Beschreibung
hash	string	Ja	Der eindeutige Bestätigungs-Hash aus der Bestätigungs-E-Mail (URL-Parameter).

Antwort: 204 No Content bei Erfolg.

Fehler:

• 404 Not Found – Ungültiger oder bereits bestätigter Hash.