Schnellstart

Öffnen Sie im Dashboard Einstellungen → Organisation → API-Schlüssel und erstellen Sie einen Schlüssel. Wählen Sie Lesen, um nur Daten abzurufen, oder Schreiben, um sie auch zu ändern. Dafür ist die Admin-Rolle nötig.

Die ersten fünf Produkte abrufen:

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"]

Preise sind in Rappen (120 = CHF 1.20):

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

meta.nextCursor als cursor übergeben und wiederholen, bis die Antwort kein nextCursor mehr enthält:

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

start und end sind Pflicht (UTC mit Z), paymentState ist optional:

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"