Iniziare con l'API di Lengow

L'API pubblica di Lengow è disponibile per tutti i nostri clienti che hanno sottoscritto questa opzione e vendono prodotti sui marketplace.
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 iscriverti registrati per un account Lengow. Questo ti permetterà di autenticarti e connetterti all'API. 

La nostra documentazione tecnica API è qui.
L'API di Lengow utilizza lo standard REST.

In questa guida ti consigliamo di utilizzare Postman per aiutarti a integrare e testare la nostra API.

Lengow non fornisce supporto su Postman.

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.

Maggiori 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 si conosce come 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&pagina=5&dimensione_pagina=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 è prefissato 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

Una spedizione viene creata quando uno o più articoli dell'ordine vengono inviati al cliente, un ritorno 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.

Il processo completo degli ordini con Lengow è descritto qui.

D'accord, veuillez me fournir le texte à traduire.
Questo articolo è stato tradotto automaticamente. In caso di dubbio, faccia riferimento alle versioni originali in inglese o in francese.

Articoli in questa sezione

I nostri orari di assistenza
Dan Lunedì al Venerdì dalle ore 9:00 alle ore 6:30