Démarrage rapide

Dans le dashboard, ouvrez Paramètres → Organisation → Clés API et créez une clé. Choisissez Lecture pour seulement lire les données, ou Écriture pour aussi les modifier. Le rôle Admin est requis.

Récupérer les cinq premiers produits :

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

Les prix sont en centimes (120 = CHF 1.20) :

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

Transmettez meta.nextCursor dans cursor et répétez jusqu’à ce que la réponse ne contienne plus de nextCursor :

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

start et end sont obligatoires (UTC avec Z), paymentState est facultatif :

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"