Introduzione

API clienti scango.ch

API REST per integrazioni: prodotti, ordini, fornitori e categorie.

https://dashboard.scango.ch/api/v1

Crea una chiave API in Impostazioni → Organizzazione → Chiavi:

Autorizzazione: Bearer <api-key>

Lettura — GET
Scrittura — anche creazione, aggiornamento ed eliminazione di prodotti, categorie, fornitori e negozi

Gli importi monetari sono interi in centesimi (120 = CHF 1.20)
Gli endpoint di elenco restituiscono { data, meta }. Usa limit (predefinito 100, max 5000)
offset esiste solo per la ricerca prodotti con q (max 250 per pagina)
Senza q: paginare con cursor opzionale; seguire meta.nextCursor finché assente. Le voci eliminate dal catalogo sono escluse — returned < limit non significa fine elenco; continuare finché nextCursor è presente
Gli ordini richiedono start e end; paymentState è opzionale. Usare cursor allo stesso modo per elencare gli ordini. Gli ordini eliminati sono esclusi salvo includeDeleted=true
Nessun webhook — effettua il polling degli ordini
Immagini prodotto: impostare imageUrl in create/update, oppure POST /products/{productId}/image (multipart file); eliminare con DELETE /products/{productId}/image

Vedi Guida rapida per una prima richiesta curl.