Gli account senza accesso alla beta riceveranno una risposta 403 Forbidden.
/catalogues
Questo endpoint della Lengow API ti consente di gestire i tuoi cataloghi prodotti senza dover fare affidamento su importazioni manuali o aggiornamenti tramite interfaccia utente. Ti permette di:
Recuperare i cataloghi esistenti e le 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 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 cataloghi esistenti.
La struttura del catalogo deve prima essere creata sulla piattaforma Lengow prima di poter essere gestita tramite API.
Funzionalità API supportate
| Funzionalità | Stato |
|---|---|
| Cataloghi | |
| Elencare i cataloghi e le 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 i 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 gli 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 i 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 il catalogo utilizza il "catalogue_id" per restituire i metadati di un catalogo principale o di una fonte aggiuntiva (come il nome, lo 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, data-id="115"Mappatura iniziale degli attributi prodotto
Quando chiami un endpoint prodotto (ad esempio, Ottenere prodotto), devi fornire il valore 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 i cataloghi | Recuperare tutti i cataloghi e le fonti aggiuntive sull'account | Ottenere il catalogue_id di un catalogo | Restituisce tutti i cataloghi accessibili sull'account |
| Ottenere il catalogo | Recuperare i dettagli del catalogo tramite catalogue_id | Ottenere il product_id_key di un catalogo | - Restit come nome, stato, product_id_key, ecc. - Indica l'ultimo aggiornamento (modifica da parte dell'utente) e l'ultima indicizzazione (recupero da parte di 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 sono visualizzate |
| Ottenere prodotto | Recuperare un singolo prodotto tramite product_id_key | Ispezionare o effettuare il debug di un prodotto | - Restituisce tutti i valori degli attributi per 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 di 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 |