Introduction

API client scango.ch

API REST pour les intégrations : produits, commandes, fournisseurs et catégories.

https://dashboard.scango.ch/api/v1

Créez une clé API sous Paramètres → Organisation → Clés :

Autorisation: Bearer <api-key>

Lecture — GET
Écriture — permet aussi de créer, mettre à jour et supprimer des produits, catégories, fournisseurs et magasins

Les montants monétaires sont des entiers en centimes (120 = CHF 1.20)
Les endpoints de liste renvoient { data, meta }. Utilisez limit (défaut 100, max 5000)
offset n’existe que pour la recherche produit avec q (max 250 par page)
Sans q : paginer avec cursor optionnel ; suivre meta.nextCursor jusqu’à son absence. Les entrées supprimées du catalogue sont exclues — returned < limit ne signifie pas la fin ; continuer tant que nextCursor est présent
Les commandes exigent start et end ; paymentState est optionnel. Utiliser cursor de la même façon pour lister les commandes. Les commandes supprimées sont exclues sauf avec includeDeleted=true
Pas de webhooks — interrogez les commandes par polling
Images produit : définir imageUrl en create/update, ou POST /products/{productId}/image (multipart file) ; supprimer avec DELETE /products/{productId}/image

Voir Démarrage rapide pour une première requête curl.