Cet article explique comment mettre en place une API Winkelstraat étape par étape.
Étape 1 : Demandez vos identifiants pour l'API Winkelstraat.nl
Pour Winkelstraat, vous avez besoin d'un ID client et d'une clé afin d'établir une connexion API valide. Pour obtenir ces identifiants, vous devez les demander en envoyant un e-mail à contentapi@winkelstraat.nl.
Lorsque vous avez reçu vos identifiants Winkelstraat, vous pourrez créer la connexion API dans Channable.
Étape 2 : Créez une connexion API Winkelstraat.nl dans Channable
Pour créer une nouvelle connexion Winkelstraat, rendez-vous sur le projet sur lequel vous travaillez et naviguez jusqu'à l'onglet API. Cliquez sur "+Ajouter nouvelle API" puis sur "+Ajouter une nouvelle connexion". Vous pouvez maintenant sélectionner la Winkelstraat :
Après avoir sélectionné l'API Winkelstraat, donnez un nom à la connexion et remplissez votre ID Client et votre clé :
Étape 3 : Créez vos listes de produits dans Channable
Suivez les quatre étapes ci-dessous pour configurer vos listes de produits pour Winkelstraat.nl.
1. Catégories
Configurez vos catégories Winkelstraat en utilisant la fonction de génération de catégories ou créez manuellement de nouvelles catégories.
2. Règles
Créez différentes règles pour optimiser les données relatives à vos produits. Consultez notre article concernant les règles courantes pour obtenir quelques exemples.
3. Construire
Vous trouverez dans l'étape "Construire" notre modèle prédéfini pour vos produits. Il vous suffit de le remplir en cliquant sur un champ et en sélectionnant ce que vous souhaitez renseigner. Par exemple, le champ "Nom" doit afficher le titre de votre produit, etc.
Remarque : le champ "ID du groupe de produits" est obligatoire. Habituellement, le champ que vous pouvez utiliser ici est appelé "item_group_id" ou "parent_id".
4. Attributs
Il vous faut maintenant remplir les champs de l'étape "Attributs". Vous devez au moins remplir les attributs obligatoires, ceux-ci s'afficheront en rouge s'ils sont vides.
Vous trouverez une explication plus détaillée concernant ce qu'il faut indiquer dans l'étape "Attributs" dans notre article à ce sujet.
Remarque : Pour l'instant, le champ EAN n'est pas obligatoire pour envoyer vos produits sur Winkelstraat, mais il reste fortement recommandé par la plateforme.
Remarque II : Les images et la description doivent également être ajoutées dans les Attributs. Même si elles n'apparaissent pas en rouge lorsqu'elles sont vides, elles demeurent obligatoires.
Étape 4 : Envoyez vos listes de produits sur Winkelstraat.nl
Une fois que vous avez terminé la configuration de vos listes de produits, vous pouvez commencer à les envoyer sur Winkelstraat.nl. Si vous n'avez pas encore activé le projet, naviguez vers "Installation > Paramètres du projet" et activez le projet. Ensuite, retournez à l'onglet "API", allez dans les paramètres de votre API Winkelstraat pour l'activer. Lorsque vous cliquerez sur "Exécuter" dans l'aperçu de l'API, vos produits seront envoyés sur Winkelstraat.nl !
Remarque : Pour Winkelstraat, il n'est pas possible d'exclure des produits de votre compte, mais seulement de les mettre en stock=0, ce qui désactive le produit sur la plateforme. Par conséquent, si pour une raison quelconque vous voulez exclure vos produits de la plateforme, il vous suffit d'envoyer à nouveau les produits, mais avec le stock à 0.
Étape 5 : Vérifiez vos produits à l'étape "Résultat"
Une fois l'exécution de l'API terminée, vous pourrez vérifier les résultats dans l'étape Résultat de votre API Winkelstraat. Vous verrez combien d'articles ont été envoyés avec succès et si des erreurs sont apparues. Les articles comportant une erreur n'ont pas été envoyés vers la plateforme. Cliquez sur une erreur pour obtenir le message expliquant la raison de cette dernière et pour visualiser les produits qui présentent cette erreur.
Vous pouvez essayer de résoudre les erreurs en optimisant ou en modifiant les données des produits que vous envoyez à Winkelstraat dans les catégories, les règles, l'étape "construire" et les attributs. Après chaque optimisation, relancez l'API et vérifiez les résultats.