Aller au contenu principal

API des règles de produit

Les règles de produit vous permettent d'enrichir ou de remplacer les données des produits importés depuis des sources externes (comme les flux de fournisseurs). Grâce aux règles, vos optimisations manuelles sont conservées et ne seront pas écrasées par les prochaines synchronisations de la source.

Créer ou modifier une règle de produit​

Utilisez ce point de terminaison pour créer une nouvelle règle ou modifier une règle existante pour un produit et un champ donnés.

Point de terminaison​

POST /api/portal/products/save-rule

Authentification​

Ce point de terminaison nécessite une authentification par clé API.

Corps de la requête​

ChampTypeObligatoireDescription
productstring (UUID)OuiL'identifiant unique du produit dans StoreLinkr.
sourcestringOuiLe code de la source d'importation (par exemple le nom interne de votre fournisseur).
fieldstringOuiLe nom du champ à remplacer (par exemple name, brand, model, short_description, long_description, sku, category).
valuestringOuiLa nouvelle valeur enrichie du champ.

Exemple de requête​

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

Réponse​

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

Supprimer une règle de produit​

Pour supprimer une règle d'enrichissement et revenir à la valeur importée d'origine, utilisez le point de terminaison de suppression.

Point de terminaison​

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

ParamètreTypeDescription
{rule_uuid}string (UUID)L'identifiant unique de la règle à supprimer.

Exemple de requête​

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

Bonnes pratiques pour l'enrichissement via l'API​

  • Persistance des ID : utilisez toujours le product_uuid StoreLinkr comme référence pour les règles.
  • Cohérence des champs : veillez à ce que le nom du field corresponde au schéma interne de StoreLinkr.
  • Traitement en masse : si vous enrichissez des milliers de produits, échelonnez vos appels à l'API pour éviter d'atteindre les limites de débit.