L'API di Lengow consente di recuperare gli ordini effettuati sui marketplace e di agire su questi ordini. Al momento, l'API riguarda solo i marketplace e gli ordini, non i prodotti o i cataloghi.
Tutto quello che devi sapere sulla nostra amata API di Lengow!
Su questa pagina ti aiuteremo a iniziare con i nostri casi d'uso dell'API e i concetti chiave spiegati.
Tieni presente che offriamo una soluzione plugin per my.lengow.io che puoi utilizzare invece della nostra API se hai un back office su Prestashop, Magento, Shopify, Shopware o Woocommerce.
Prima di iniziare a connetterti alla nostra API devi fare iscriviti per un account Lengow. Questo ti permetterà di autenticarti e connetterti all'API.
La nostra documentazione tecnica API è qui.
L'API di Lengow è un'API basata su REST che ti permette di:
- Elenca e recupera gli ordini del tuo account
- Esegui azioni sugli ordini: accettazione, spedizione, annullamento e rimborso
- Visualizza l'elenco completo delle possibili azioni di ordine autorizzate da ciascun marketplace, a quale stato e con quali parametri obbligatori o opzionali
- Recupera i documenti di fatturazione
- Comunica con il magazzino di Zalando
Consigli di Lengow:
Attraverso questa guida ti consigliamo di utilizzare Postman per aiutarti a integrare e testare la nostra API.
Lengow non fornisce supporto su Postman.
Il bilanciatore di carico in ingresso ha un timeout di 350 secondi sul Keep-Alive. Se la richiesta è più lunga di questo, si verificherà un errore di connessione a causa del superamento di questo limite.
Concetti chiave
Prima di iniziare, dovresti capire alcuni concetti centrali nell'API:
- API
Un' interfaccia di programmazione delle applicazioni (API) è un'interfaccia di calcolo che definisce le interazioni tra più intermediari software.
Funziona su un principio di input e output, il che significa che viene utilizzato per inviare azioni e recuperare informazioni tra due sistemi.
L'API stessa definisce i tipi di chiamate all'azione e le richieste che possono essere fatte, come farle, e il formato previsto che deve essere utilizzato perché funzioni.
Altre informazioni qui.
- Token di accesso
Per autenticarti devi ottenere un token di accesso. È un blocco di caratteri che contiene le credenziali di sicurezza per una sessione di login e identifica l'utente (tu).
Esempio di token: "6b7280eb-e7d4-4b94-a829-7b3853a20126"
- Intestazione di autorizzazione
>L'intestazione di autorizzazione contiene le tue credenziali di autenticazione. Una volta ottenuto il tuo token, tutte le tue richieste API avranno bisogno di un'intestazione di autorizzazione.
- Punto finale
La posizione in cui l'API invia una richiesta e da cui proviene la risposta è ciò che viene definito come un punto finale.
- Paginazione
Un esempio comune per i parametri di query è la paginazione. Le risorse che restituiscono elenchi di entità sono tutte paginate. Per utilizzare la paginazione, l'utente specifica un parametro di query pagina con un dato numero di pagina, un intero non negativo. Quando omesso, il valore predefinito per la pagina è 1.
Esempio: /orders/?account_id=1&page=5&page_size=50
Parametri di query (Filtraggio)
Con l'uso dei parametri di query, gli utenti possono definire filtri aggiuntivi che possono limitare il numero di entità restituite nella risposta. Gli utenti possono specificare a piacere i parametri di query e combinarli. I parametri di query vengono aggiunti alla fine di un percorso di risorsa.
Il primo parametro di query è preceduto da "?", tutti i parametri di query aggiuntivi sono separati dal simbolo "&".
Esempio: /orders/?account_id=1&marketplace=menlook
- Prodotti
Un prodotto è qualsiasi articolo che può essere inviato da Lengow a un canale. È generalmente definito dal suo codice di numerazione degli articoli europei (EAN), o da un ID unico che hai scelto e arricchito con descrizioni, immagini e altri contenuti.
- Ordini e articoli dell'ordine
Quando un cliente acquista uno o più articoli su un canale viene creato un ordine. L'ordine contiene uno o più articoli dell'ordine. Ogni articolo dell'ordine contiene un ID unico, quantità, prezzo, riferimento cliente, ecc...
- Altri concetti e flussi
Un La spedizione viene creata quando uno o più articoli dell'ordine vengono inviati al cliente, un resi viene creato quando un cliente vuole restituire un articolo dell'ordine e una cancellazione viene utilizzata per annullare un ordine o un articolo dell'ordine.
L'intero processo di ordini con Lengow è descritto qui.
