Les comptes sans accès à la bêta recevront une réponse 403 Forbidden.
/catalogues
Cet endpoint de l'API Lengow vous permet de gérer vos catalogues produits sans avoir recours à des importations manuelles ou des mises à jour via l'interface utilisateur. Il vous permet de :
Récupérer vos catalogues existants et sources additionnelles
Visualiser les structures des catalogues et les attributs
Lister, récupérer, créer, mettre à jour et supprimer un produit ou un groupe de produits
Maintenir la synchronisation continue de vos données produits depuis vos systèmes (PIM, ERP, outils personnalisés)
L'API Catalogues NE prend PAS en charge la création de catalogues. Elle ne peut être utilisée que pour mettre à jour et modifier des catalogues existants.
La structure du catalogue doit d'abord être créée sur la plateforme Lengow avant de pouvoir être gérée via l'API.
Mises à jour API et synchronisation du catalogue
Lorsqu'un produit est mis à jour via l'API Catalogues, la modification est appliquée immédiatement dans Lengow. Selon votre architecture de données, vous pouvez choisir la manière dont l'API interagit avec vos imports de catalogue standards :
Option 1 : Mises à jour API + Imports de catalogue planifiés
Si votre catalogue est également synchronisé via un import de fichier planifié, la prochaine actualisation du fichier restera la source de données faisant autorité et écrasera les informations du produit avec les valeurs contenues dans le dernier fichier.
En pratique, c'est une excellente méthode tant que les données produits de votre fichier source sont à jour. Ce mécanisme hybride vous permet de pousser des données urgentes (comme des baisses de stock) via l'API pendant la journée, tandis qu'une mise à jour nocturne planifiée garantit que votre catalogue reste parfaitement aligné avec votre source de données principale et assure la cohérence de tous les produits.
Option 2 : Mises à jour API uniquement
- ✓ Mises à jour des produits en temps réel
- ✓ Aucune mise à jour planifiée
Si vous n'avez pas besoin d'une synchronisation régulière basée sur des fichiers et que vous souhaitez que l'API soit votre seul mécanisme de gestion de catalogue, vous pouvez supprimer complètement les mises à jour planifiées. Pour utiliser ce mode, laissez simplement le calendrier de synchronisation du catalogue vide dans l'interface Lengow.
Tester l'API Catalogues dans la Lengow Sandbox
Vous pouvez utiliser la Lengow Sandbox pour tester l'API Catalogues, en ouvrant un compte Sandbox ici : https://my.lengow.net/registration
Dans votre compte Sandbox, ajoutez un catalogue. Contactez ensuite l'équipe Support Lengow pour demander accès à l'API Catalogues (indiquez l'identifiant de votre compte Sandbox dans le ticket).
Les appels API peuvent être effectués en ciblant l’environnement .net (sandbox) au lieu du .io habituel (production).
Documentation API : https://api.lengow.io/docs/
Fonctionnalités API prises en charge
| Fonctionnalité | Statut |
|---|---|
| Catalogues | |
| Lister les catalogues et sources additionnelles | ✅ Pris en charge |
| Obtenir les métadonnées d'un catalogue ou source additionnelle par catalogue_id | ✅ Pris en charge |
| Créer un catalogue | ❌ Non pris en charge |
| Activer, désactiver, supprimer un catalogue | ❌ Non pris en charge |
| Visualiser un segment | ❌ Non pris en charge |
| Produits | |
| Lister les produits d'un catalogue | ✅ Pris en charge |
| Obtenir un produit par product_id_key | ✅ Pris en charge |
| Créer ou remplacer des produits (unitaire ou en masse) | ✅ Pris en charge |
| Mise à jour partielle d'un produit ou groupe de produits (unitaire ou en masse) | ✅ Pris en charge |
| Supprimer des produits (unitaire ou en masse) | ✅ Pris en charge |
| Récupérer les règles d'optimisation dans les données produit | ❌ Non pris en charge |
| Attributs | |
| Lister les attributs d'un catalogue ou d'une source additionnelle | ✅ Pris en charge |
| Créer des attributs | ❌ Non pris en charge |
| Mettre à jour des attributs | ❌ Non pris en charge |
| Supprimer des attributs | ❌ Non pris en charge |
| Lister les attributs des sources additionnelles via le catalogue principal | ❌ Non pris en charge |
Concepts clés
- catalogue_id
Les requêtes API doivent cibler un catalogue spécifique en utilisant son "catalogue_id".
- "List catalogues" est généralement le premier endpoint à appeler car il retourne la liste de tous les catalogues principaux et sources additionnelles disponibles sur le compte. Cela inclut le "catalogue_id" de chacun, qui est utilisé pour toutes les requêtes suivantes.
- "Get catalogue" utilise le "catalogue_id" pour retourner les métadonnées d'un catalogue principal ou d'une source additionnelle (telles que son nom, statut, product_id_key, etc.).
Exemple de réponse pour GET /catalogues/{catalogue_id} :
{
"catalogue_id": 95000,
"name": "Main Catalogue",
"status": "enabled",
"product_id_key": "id_product",
"created_at": "2024-09-11T10:42:28.661555Z",
"updated_at": "2025-11-06T13:57:48.078126Z",
"indexed_at": "2025-11-06T13:57:49.571801Z",
"source": "link",
"products_count": 2134
}- product_id_key
Toutes les opérations API liées aux produits se basent sur le "product_id_key" (voir l'exemple de réponse ci-dessus).
Le "product_id_key" est défini dans les paramètres de votre catalogue dans Lengow et identifie le champ qui contient l'identifiant unique des produits.
Pour plus d'informations, voir Correspondance des champs principaux
Lors de l'appel d'un endpoint produit (par exemple "Get product"), vous devez fournir la valeur de l'identifiant produit stockée dans le champ du catalogue défini comme product_id_key.
Aperçu des endpoints API
| Opération | Objectif du endpoint | Cas d'usage typique | Comportement |
|---|---|---|---|
| Catalogues | |||
| List catalogues | Récupérer tous les catalogues et sources additionnelles du compte | Obtenir le catalogue_id d'un catalogue | Retourne tous les catalogues accessibles sur le compte |
| Get catalogue | Récupérer les détails d'un catalogue par catalogue_id | Obtenir le product_id_key d'un catalogue | - Retourne les informations du catalogue telles que nom, statut, product_id_key, etc. - Indique la dernière mise à jour (modification par l'utilisateur) et la dernière indexation (récupération par Lengow) |
| Attributs | |||
| List attributes | Récupérer la liste des attributs d'un catalogue | Comprendre la structure du catalogue | - Retourne tous les noms de champs présents dans le catalogue - Les attributs des sources additionnelles ne sont pas affichés dans le catalogue principal |
| Produits | |||
| List products | Récupérer tous les produits d'un catalogue | Parcourir ou exporter les données du catalogue | - Retourne les produits disponibles dans le catalogue, incluant toutes les valeurs d'attribut pour chaque produit - Les règles d'optimisation ajoutées sur la plateforme Lengow ne sont pas affichées |
| Get product | Récupérer un produit unique par product_id_key | Inspecter ou debugger un produit | - Retourne toutes les valeurs d'attribut pour un seul produit - product_id_key requis |
| Create or replace products | Créer ou écraser totalement les données produit | Resynchronisation complète du catalogue | - Purge & remplace : écrase les données existantes - product_id_key requis - Disponible en mode unitaire ou en masse |
| Partial update products | Mettre à jour uniquement certains champs produits | Mises à jour de prix & stock | - Met à jour uniquement les champs fournis (les champs non spécifiés restent inchangés) - product_id_key requis - Disponible en mode unitaire ou en masse - Pour les sources additionnelles, ajoutez le Source ID en préfixe du nom de l'attribut. Ex. : SRC_123456:nomattribut
|
| Delete products | Supprimer des produits du catalogue | Retirer des produits obsolètes | - Supprime les produits sur la base du product_id_key - Disponible en mode unitaire ou en masse |