Passer au contenu principal

Comment mettre à jour les produits de votre catalogue via Postman (API)

Procédure pour mettre à jour en masse les produits de votre catalogue Ezus avec Postman.

Aucune compétence technique avancée n'est nécessaire, il suffit de suivre les étapes ci-dessous :

Prérequis

💡 Bon à savoir : l'authentification à l'API repose sur deux éléments :

  • la clé API (x-api-key) qui identifie votre compte

  • le token (Authorization: Bearer) qui autorise chaque requête

Le token est valable 12 heures ; passé ce délai, il faut le régénérer.

Note : l'adresse de l'API est https://api.ezus.app. La page api.ezus.io correspond uniquement à la documentation.

Étape 1 — Préparer la requête de mise à jour d'un produit

La mise à jour d'un produit se fait via la route products-upsert.

  1. Méthode POST, URL : {{baseUrl}}/products-upsert (ou directement https://api.ezus.app/products-upsert)
    ​

  2. Onglet Headers :

    • x-api-key → votre clé API

    • Authorization → Bearer suivi de votre token

    • Content-Type → application/json

  3. Onglet Body → raw → JSON.
    ​

Exemple pour mettre à jour le titre d'un produit :

{     "reference": "REFERENCE_DU_PRODUIT",     "title": "Nouveau titre du produit" }

💡 Si vous souhaitez mettre à jour les informations de votre produit dans une autre langue (que celle la langue par défaut de votre compte), vous devrez utiliser le bloc langs.

Par exemple, pour mettre à jour le titre d'un produit en anglais :

{     "reference": "REFERENCE_DU_PRODUIT",     "langs": [         {             "lang": "american",             "name": "English product name"         }     ] }

Point clé : la référence

Le champ reference est la clé qui identifie le produit à mettre à jour. Elle correspond à la colonne « API field » de votre export de produits (et non à la colonne « Product reference », qui correspond au numéro de dossier info_number).

⚠️ Si la référence fournie n'existe pas, l'API créera un nouveau produit au lieu d'en modifier un. Nous vous recommandons ainsi de toujours vérifier la référence.

💡 Seuls les champs envoyés sont modifiés : si vous n'envoyez que reference et title, les autres informations du produit (prix, catégorie, descriptions…) restent inchangées.

Étape 2 — Tester une seule requête

Avant toute mise à jour en masse, nous vous recommandons de tester sur un seul produit :

  1. Ouvrez une requête, vérifiez l'URL, les Headers et le Body.

  2. Cliquez sur Send.

  3. Dans la zone Response, vous devrez voir un statut 200 OK et une réponse du type : 

{     "error": "false",     "message": "ok",     "action": "Product successfully updated",     "reference": "REFERENCE_DU_PRODUIT" }

4. Vérifiez dans Ezus que le produit a bien été mis à jour.

Étape 3 — Mettre à jour vos produits en masse

Pour modifier en masse les titres et descriptions de plusieurs produits, vous pouvez utilise une collection contenant une requête par produit et lancez le Collection Runner :

  1. Survolez le nom de la collection dans le panneau de gauche → cliquez sur les ··· → Run collection.

  2. Vérifiez que toutes les requêtes à exécuter sont cochées.

  3. Laissez un délai (Delay) d'environ 200 ms entre les requêtes.

  4. Laissez l'option « Stop run if an error occurs » cochée : en cas d'erreur, l'exécution s'arrête, ce qui permet d'identifier la requête concernée.

  5. Cliquez sur Start run. Chaque produit s'affiche avec un statut Passed ou Failed.
    ​

Résolution des problèmes courants

  • Erreur 401 / 403 : problème d'authentification. Vérifiez la clé API et le token, et assurez-vous qu'il n'y a pas d'espace superflu. Si le token a plus de 12 heures, régénérez-le.

  • Un nouveau produit a été créé au lieu d'être mis à jour : la reference envoyée ne correspondait à aucun produit existant. Utilisez bien la valeur de la colonne « API field ».

  • Le bloc langs est refusé : la langue concernée (ex. « american ») doit être activée sur votre compte Ezus.

Avez-vous trouvé la réponse à votre question ?