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.
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 |
| 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 |