Gli account senza accesso beta riceveranno una risposta 403 Forbidden.
/catalogues
Questo endpoint della Lengow API ti consente di gestire i tuoi cataloghi di prodotti senza dover ricorrere a import manuali o aggiornamenti tramite interfaccia utente. Ti permette di:
Recuperare i tuoi cataloghi esistenti e fonti aggiuntive
Leggere le strutture e gli attributi dei cataloghi
Elencare, recuperare, creare, aggiornare ed eliminare un singolo prodotto o un gruppo di prodotti
Mantenere i dati dei tuoi prodotti costantemente sincronizzati dai tuoi sistemi (PIM, ERP, strumenti personalizzati)
L'API Cataloghi NON supporta la creazione di cataloghi. Può essere utilizzata solo per aggiornare e modificare i cataloghi esistenti.
La struttura del catalogo deve essere prima creata sulla piattaforma Lengow prima di poter essere gestita tramite API.
Funzionalità API supportate
| Funzionalità | Stato |
|---|---|
| Cataloghi | |
| Elencare cataloghi e fonti aggiuntive | ✅ Supportato |
| Ottenere i metadati di un catalogo o fonte aggiuntiva tramite catalogue_id | ✅ Supportato |
| Creare un catalogo | ❌ Non supportato |
| Abilitare, disabilitare, eliminare un catalogo | ❌ Non supportato |
| Leggere segmento | ❌ Non supportato |
| Prodotti | |
| Elencare prodotti in un catalogo | ✅ Supportato |
| Ottenere un prodotto tramite product_id_key | ✅ Supportato |
| Creare o sostituire prodotti (singolo o bulk) | ✅ Supportato |
| Aggiornamento parziale di 1 prodotto o di un gruppo di prodotti (singolo o bulk) | ✅ Supportato |
| Eliminare prodotti (singolo o bulk) | ✅ Supportato |
| Recuperare regole di ottimizzazione nei dati prodotto | ❌ Non supportato |
| Attributi | |
| Elencare attributi in un catalogo o fonte aggiuntiva | ✅ Supportato |
| Creare attributi | ❌ Non supportato |
| Aggiornare attributi | ❌ Non supportato |
| Eliminare attributi | ❌ Non supportato |
| Elencare attributi da fonti aggiuntive tramite il catalogo principale | ❌ Non supportato |
Concetti chiave
- catalogue_id
Le richieste API devono essere indirizzate a uno specifico catalogo utilizzando il suo "catalogue_id".
- Elencare cataloghi è solitamente il primo endpoint da chiamare poiché restituisce un elenco di tutti i cataloghi principali e delle fonti aggiuntive disponibili sull'account. Include il "catalogue_id" per ciascuno, che viene utilizzato per tutte le richieste successive.
- Ottenere catalogo utilizza il "catalogue_id" per restituire i metadati di un catalogo principale o di una fonte aggiuntiva (come nome, stato, product_id_key, ecc.).
Esempio di risposta per 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
Tutte le operazioni API relative ai prodotti si basano sul "product_id_key" (mostrato nella risposta sopra).
Il "product_id_key" è definito nelle impostazioni del tuo catalogo in Lengow e identifica il campo che contiene l'ID univoco del prodotto.
Per maggiori informazioni, consulta Mappatura iniziale degli attributi prodotto
Quando chiami un endpoint prodotto (ad esempio, Ottenere prodotto), devi fornire il valore dell'ID prodotto memorizzato nel campo del catalogo definito come product_id_key.
Panoramica degli endpoint API
| Operazione | Scopo dell'endpoint | Caso d'uso tipico | Comportamento |
|---|---|---|---|
| Cataloghi | |||
| Elencare cataloghi | Recuperare tutti i cataloghi e fonti aggiuntive sull'account | Ottenere il catalogue_id di un catalogo | Restituisce tutti i cataloghi accessibili sull'account |
| Ottenere catalogo | Recuperare i dettagli del catalogo tramite catalogue_id | Ottenere il product_id_key di un catalogo | - Restituisce informazioni sul catalogo come nome, stato, product_id_key, ecc. - Indica l'ultimo aggiornamento (modifica da parte dell'utente) e l'ultima indicizzazione (recupero da Lengow) |
| Attributi | |||
| Elencare attributi | Recuperare l'elenco degli attributi di un catalogo | Comprendere la struttura del catalogo | - Restituisce tutti i nomi dei campi presenti nel catalogo - Gli attributi delle fonti aggiuntive non sono mostrati nel catalogo principale |
| Prodotti | |||
| Elencare prodotti | Recuperare tutti i prodotti da un catalogo | Esplorare o esportare i dati del catalogo | - Restituisce i prodotti disponibili nel catalogo, inclusi tutti i valori degli attributi per ciascun prodotto - Le regole di ottimizzazione aggiunte nella piattaforma Lengow non vengono visualizzate |
| Ottenere prodotto | Recuperare un singolo prodotto tramite product_id_key | Ispezionare o fare debug di un prodotto | - Restituisce tutti i valori degli attributi di un singolo prodotto - product_id_key richiesto |
| Creare o sostituire prodotti | Creare o sovrascrivere completamente i dati prodotto | Risincornizzazione completa del catalogo | - Purge & replace: sovrascrive i dati esistenti - product_id_key richiesto - Disponibile in modalità singola o bulk |
| Aggiornamento parziale prodotti | Aggiornare solo i campi selezionati del prodotto | Aggiornamenti prezzo & stock | - Aggiorna solo i campi forniti (i campi non specificati restano invariati) - product_id_key richiesto - Disponibile in modalità singola o bulk |
| Eliminare prodotti | Eliminare prodotti dal catalogo | Rimuovere prodotti obsoleti | - Elimina prodotti in base al product_id_key - Disponibile in modalità singola o bulk |