Guida rapida

Nel dashboard aprite Impostazioni → Organizzazione → Chiavi API e create una chiave. Scegliete Lettura per leggere soltanto i dati, oppure Scrittura per modificarli. Serve il ruolo Admin.

Recuperare i primi cinque prodotti:

curl -sS \
  -H "Authorization: Bearer $SCANGO_API_KEY" \
  "https://dashboard.scango.ch/api/v1/products?limit=5"

const response = await fetch("https://dashboard.scango.ch/api/v1/products?limit=5", {
  headers: { Authorization: `Bearer ${process.env.SCANGO_API_KEY}` },
});
const { data, meta } = await response.json();

import os
import requests

response = requests.get(
    "https://dashboard.scango.ch/api/v1/products",
    params={"limit": 5},
    headers={"Authorization": f"Bearer {os.environ['SCANGO_API_KEY']}"},
)
data = response.json()["data"]

I prezzi sono in centesimi (120 = CHF 1.20):

{
  "data": [{ "id": "a1b2c3", "name": "Acqua minerale 50cl", "price": 120 }],
  "meta": { "total": 5, "returned": 5, "limit": 5, "nextCursor": "a1b2c3" }
}

Passate meta.nextCursor come cursor e ripetete finché la risposta non contiene più nextCursor:

curl -sS \
  -H "Authorization: Bearer $SCANGO_API_KEY" \
  "https://dashboard.scango.ch/api/v1/products?limit=5&cursor=a1b2c3"

start ed end sono obbligatori (UTC con Z), paymentState è facoltativo:

curl -sS \
  -H "Authorization: Bearer $SCANGO_API_KEY" \
  "https://dashboard.scango.ch/api/v1/orders?start=2024-01-01T00:00:00.000Z&end=2024-01-31T23:59:59.999Z&paymentState=successful"