Aller au contenu
scango.ch
Français
Esc
naviguerouvrir⌘Japerçu
Sur cette page

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 }. 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, end et paymentState ; utiliser cursor de 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

Cette page vous a-t-elle été utile ?