Las cuentas sin acceso beta recibirán una respuesta 403 Forbidden.
/catalogues
Este endpoint de la API de Lengow te permite gestionar tus catálogos de productos sin depender de importaciones manuales o actualizaciones basadas en la interfaz de usuario. Te permite:
Recuperar tus catálogos existentes y fuentes adicionales
Leer estructuras y atributos del catálogo
Listar, recuperar, crear, actualizar y eliminar un solo producto o un grupo de productos
Mantener tus datos de productos sincronizados continuamente desde tus sistemas (PIM, ERP, herramientas personalizadas)
La API de Catálogos NO permite la creación de catálogos. Solo puede usarse para actualizar y modificar catálogos existentes.La estructura del catálogo debe crearse primero en la plataforma de Lengow antes de poder gestionarse a través de la API.
Funciones de la API soportadas
| Función | Estado |
|---|---|
| Catálogos | |
| Listar catálogos y fuentes adicionales | ✅ Soportado |
| Obtener metadatos de un catálogo o fuente adicional por catalogue_id | ✅ Soportado |
| Crear un catálogo | ❌ No soportado |
| Habilitar, deshabilitar, eliminar un catálogo | ❌ No soportado |
| Leer segmento | ❌ No soportado |
| Productos | |
| Listar productos en un catálogo | ✅ Soportado |
| Obtener un producto por product_id_key | ✅ Soportado |
| Crear o reemplazar productos (individual o masivo) | ✅ Soportado |
| Actualización parcial de 1 producto o grupo de productos (individual o masivo) | ✅ Soportado |
| Eliminar productos (individual o masivo) | ✅ Soportado |
| Recuperar reglas de optimización en los datos de producto | ❌ No soportado |
| Atributos | |
| Listar atributos en un catálogo o fuente adicional | ✅ Soportado |
| Crear atributos | ❌ No soportado |
| Actualizar atributos | ❌ No soportado |
| Eliminar atributos | ❌ No soportado |
| Listar atributos de fuentes adicionales a través del catálogo principal |
❌ No soportado |
Conceptos clave
- catalogue_id
Las solicitudes a la API deben dirigirse a un catálogo específico usando su "catalogue_id".
- Listar catálogos suele ser el primer endpoint a llamar ya que devuelve una lista de todos los catálogos principales y fuentes adicionales disponibles en la cuenta. Incluye el "catalogue_id" de cada uno, el cual se usa para todas las solicitudes posteriores.
- Obtener catálogo utiliza el "catalogue_id" para devolver los metadatos de un catálogo principal o fuente adicional (como su nombre, estado, product_id_key, etc.).
Ejemplo de respuesta para 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
Todas las operaciones de la API relacionadas con productos dependen del "product_id_key" (mostrado en la respuesta anterior).
El "product_id_key" se define en la configuración de tu catálogo en Lengow e identifica el campo que contiene el ID único del producto.
Para más información, consulta Mapeo inicial de atributos de producto
Al llamar a un endpoint de producto (por ejemplo, Obtener producto), debes proporcionar el valor del ID de producto almacenado en el campo del catálogo definido como product_id_key.
Resumen de endpoints de la API
| Operación | Propósito del endpoint | Caso de uso típico | Comportamiento |
|---|---|---|---|
| Catálogos | |||
| Listar catálogos | Recuperar todos los catálogos y fuentes adicionales en la cuenta | Obtener el catalogue_id de un catálogo | Devuelve todos los catálogos accesibles en la cuenta |
| Obtener catálogo | Recuperar detalles del catálogo por catalogue_id | Obtener el product_id_key de un catálogo | - Devuelve información del catálogo como nombre, estado, product_id_key, etc. - Indica la última actualización (modificación por usuario) y última indexación (recuperación por Lengow) |
| Atributos | |||
| Listar atributos | Recuperar la lista de atributos de un catálogo | Entender la estructura del catálogo | - Devuelve todos los nombres de campos presentes en el catálogo - Los atributos de fuentes adicionales no se muestran en el catálogo principal |
| Productos | |||
| Listar productos | Recuperar todos los productos de un catálogo | Navegar o exportar datos del catálogo | - Devuelve los productos disponibles en el catálogo, incluyendo todos los valores de atributos de cada producto - Las reglas de optimización añadidas en la plataforma de Lengow no se muestran |
| Obtener producto | Recuperar un solo producto por product_id_key | Inspeccionar o depurar un producto | - Devuelve todos los valores de atributos de un solo producto - Se requiere product_id_key |
| Crear o reemplazar productos | Crear o sobrescribir completamente los datos del producto | Resincronización completa del catálogo | - Purgar & reemplazar: sobrescribe los datos existentes - Se requiere product_id_key - Disponible en modo individual o masivo |
| Actualización parcial de productos | Actualizar solo campos seleccionados del producto | Actualizaciones de precio & stock | - Actualiza solo los campos proporcionados (los campos no especificados permanecen sin cambios) - Se requiere product_id_key - Disponible en modo individual o masivo |
| Eliminar productos | Eliminar productos del catálogo | Eliminar productos obsoletos | - Elimina productos basados en product_id_key - Disponible en modo individual o masivo |