Productregels-API

Met productregels kun je data verrijken of overschrijven voor producten die zijn geïmporteerd vanuit externe bronnen (zoals leveranciersfeeds). Door regels te gebruiken, blijven je handmatige optimalisaties behouden en worden ze niet overschreven bij toekomstige bronsynchronisaties.

Een productregel aanmaken of bijwerken

Gebruik dit endpoint om een nieuwe regel aan te maken of een bestaande regel bij te werken voor een specifiek product en veld.

Endpoint

POST /api/portal/products/save-rule

Authenticatie

Voor dit endpoint is authenticatie via een API-key vereist.

Request body

Field	Type	Verplicht	Beschrijving
product	string (UUID)	Ja	De unieke identifier van het product in StoreLinkr.
source	string	Ja	De importbroncode (bijvoorbeeld de interne naam van je leverancier).
field	string	Ja	De veldnaam die je wilt overschrijven (bijvoorbeeld name, brand, model, short_description, long_description, sku, category).
value	string	Ja	De nieuwe, verrijkte waarde voor het veld.

Voorbeeldrequest

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"
  }'

Response

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

Een productregel verwijderen

Wil je een verrijkingsregel verwijderen en teruggaan naar de oorspronkelijk geïmporteerde waarde? Gebruik dan het delete-endpoint.

Endpoint

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

Parameter	Type	Beschrijving
{rule_uuid}	string (UUID)	De unieke identifier van de regel die je wilt verwijderen.

Voorbeeldrequest

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

Best practices voor API-verrijking

• ID-persistentie: Gebruik altijd de StoreLinkr product_uuid als referentie voor je regels.
• Veldconsistentie: Zorg dat de field-naam overeenkomt met het interne StoreLinkr-schema.
• Bulkverwerking: Verrijk je duizenden producten? Overweeg dan om je API-calls te spreiden om rate limits te voorkomen.