---
title: 'Introduzione'
description: '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**:

```http
Authorization: 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 }`. 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`

### Guida rapida

Vedi [Guida rapida](/it/api-reference/quickstart) per una prima richiesta `curl`.

OpenAPI: [`/openapi/scango.json`](/openapi/scango.json)