Produktregeln-API

Mit Produktregeln können Sie Daten von Produkten anreichern oder überschreiben, die aus externen Quellen (z. B. Lieferanten-Feeds) importiert werden. Wenn Sie Regeln verwenden, bleiben Ihre manuellen Optimierungen erhalten und werden bei künftigen Synchronisierungen der Quelle nicht überschrieben.

Produktregel erstellen oder aktualisieren

Mit diesem Endpunkt erstellen Sie eine neue Regel oder aktualisieren eine vorhandene für ein bestimmtes Produkt und Feld.

Endpunkt

POST /api/portal/products/save-rule

Authentifizierung

Dieser Endpunkt erfordert eine Authentifizierung per API-Schlüssel.

Request-Body

Feld	Typ	Erforderlich	Beschreibung
product	string (UUID)	Ja	Die eindeutige Kennung des Produkts in StoreLinkr.
source	string	Ja	Der Code der Importquelle (z. B. der interne Name Ihres Lieferanten).
field	string	Ja	Der Name des zu überschreibenden Feldes (z. B. name, brand, model, short_description, long_description, sku, category).
value	string	Ja	Der neue, angereicherte Wert für das Feld.

Beispielanfrage

curl -X POST https://portal.storelinkr.com/api/portal/products/save-rule \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "550e8400-e29b-41d4-a716-446655440000",
    "source": "my-supplier-code",
    "field": "name",
    "value": "Optimized Product Title for SEO"
  }'

Antwort

{
  "status": "success",
  "message": "Product rule saved successfully"
}

Produktregel löschen

Um eine Anreicherungsregel zu entfernen und zum ursprünglich importierten Wert zurückzukehren, verwenden Sie den Lösch-Endpunkt.

Endpunkt

DELETE /api/portal/products/rules/{rule_uuid}

Parameter	Typ	Beschreibung
{rule_uuid}	string (UUID)	Die eindeutige Kennung der zu löschenden Regel.

Beispielanfrage

curl -X DELETE https://portal.storelinkr.com/api/portal/products/rules/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

Empfehlungen für die Anreicherung per API

• Konstante IDs: Verwenden Sie als Referenz für Regeln immer die StoreLinkr-product_uuid.
• Einheitliche Felder: Achten Sie darauf, dass der Feldname zum internen StoreLinkr-Schema passt.
• Massenverarbeitung: Wenn Sie Tausende von Produkten anreichern, verteilen Sie Ihre API-Aufrufe zeitlich, um Ratenlimits zu vermeiden.