Gli account senza accesso alla beta riceveranno una risposta 403 Forbidden.
/catalogues
Questo endpoint della API Lengow ti permette di gestire i tuoi cataloghi di prodotti senza fare affidamento su importazioni manuali o aggiornamenti basati sull'interfaccia utente. Ti consente di:
Recuperare i tuoi cataloghi esistenti e fonti aggiuntive
Leggere le strutture e gli attributi del catalogo
Elencare, recuperare, creare, aggiornare ed eliminare un singolo prodotto o un gruppo di prodotti
Mantenere i dati dei tuoi prodotti continuamente 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 essere prima creata sulla piattaforma Lengow prima di poter essere gestita tramite API.
Puoi aggiornare il tuo catalogo tramite API mantenendo comunque la frequenza di indicizzazione programmata configurata sulla piattaforma Lengow, in base alle tue esigenze.
Importante: quando viene attivata un'indicizzazione programmata, essa sovrascriverà qualsiasi aggiornamento precedentemente effettuato tramite API.
Testare l'API Cataloghi nel Sandbox di Lengow
Puoi utilizzare il Sandbox di Lengow per testare l'API Cataloghi, aprendo un account Sandbox qui: https://my.lengow.net/registration
Nel tuo account Sandbox, aggiungi il tuo catalogo. Poi, contatta il team di Supporto Lengow per richiedere l'accesso all'API Cataloghi (fornisci l'ID del tuo account Sandbox nel ticket).
Le chiamate API possono essere effettuate puntando all'ambiente .net (sandbox) invece del solito .io (produzione).
Documentazione API: https://api.lengow.io/docs/
Funzionalità API supportate
| Funzionalità | Stato |
|---|---|
| Cataloghi | |
| Elencare cataloghi e fonti aggiuntive | ✅ Supportato |
| Ottenere metadati di catalogo o fonte aggiuntiva tramite catalogue_id | ✅ Supportato |
| Creare un catalogo | ❌ Non supportato |
| Abilitare, disabilitare, eliminare un catalogo | ❌ Non supportato |
| Leggere segmenti | ❌ Non supportato |
| Prodotti | |
| Elencare prodotti in un catalogo | ✅ Supportato |
| Ottenere un prodotto tramite product_id_key | ✅ Supportato |
| Creare o sostituire prodotti (singoli o in blocco) | ✅ Supportato |
| Aggiornamento parziale di 1 prodotto o gruppo di prodotti (singoli o in blocco) | ✅ Supportato |
| Eliminare prodotti (singoli o in blocco) | ✅ 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 puntare a un catalogo specifico utilizzando il suo "catalogue_id".
- Elencare cataloghi è tipicamente 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 usa il "catalogue_id" per restituire i metadati di un catalogo principale o 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 correlate 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 unico del prodotto.
Per maggiori informazioni, vedi 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 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 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'ultima modifica (modifica da parte dell'utente) e l'ultima indicizzazione (recupero da parte di Lengow) |
| Attributi | |||
| Elencare attributi | Recuperare l'elenco degli attributi per 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 eseguire 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 del prodotto | Risincro pieno 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 e stock | - Aggiorna solo i campi forniti (campi non specificati invariati) - product_id_key richiesto - Disponibile in modalità singola o bulk |
| Eliminare prodotti | Eliminare prodotti dal catalogo | Rimuovere prodotti obsoleti | - Elimina prodotti basati su product_id_key - Disponibile in modalità singola o bulk |