Introduzione
API clienti scango.ch
API REST per integrazioni: prodotti, ordini, fornitori e categorie.
URL di base
https://dashboard.scango.ch/api/v1
Autenticazione
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
Elementi essenziali
- Gli importi monetari sono interi in centesimi (
120= CHF 1.20) - Gli endpoint di elenco restituiscono
{ data, meta }. Usalimit(predefinito 100, max 5000) offsetesiste solo per la ricerca prodotti conq(max 250 per pagina)- Senza
q: paginare concursoropzionale; seguiremeta.nextCursorfinché assente. Le voci eliminate dal catalogo sono escluse —returned < limitnon significa fine elenco; continuare finchénextCursorè presente - Gli ordini richiedono
start,endepaymentState; usarecursorallo stesso modo per elencare gli ordini - Nessun webhook — effettua il polling degli ordini
- Nessun upload di immagini tramite l’API
Guida rapida
Vedi Guida rapida per una prima richiesta curl.
OpenAPI: /openapi/scango.json