Introduction
API client scango.ch
API REST pour les intégrations : produits, commandes, fournisseurs et catégories.
URL de base
https://dashboard.scango.ch/api/v1
Authentification
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
Essentiels
- Les montants monétaires sont des entiers en centimes (
120= CHF 1.20) - Les endpoints de liste renvoient
{ data, meta }. Utilisezlimit(défaut 100, max 5000) offsetn’existe que pour la recherche produit avecq(max 250 par page)- Sans
q: paginer aveccursoroptionnel ; suivremeta.nextCursorjusqu’à son absence. Les entrées supprimées du catalogue sont exclues —returned < limitne signifie pas la fin ; continuer tant quenextCursorest présent - Les commandes exigent
start,endetpaymentState; utilisercursorde la même façon pour lister les commandes - Pas de webhooks — interrogez les commandes par polling
- Pas d’upload d’images via l’API
Démarrage rapide
Voir Démarrage rapide pour une première requête curl.
OpenAPI : /openapi/scango.json