---
title: 'Introduction'
description: '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** :

```http
Authorization: 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` 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`

### Démarrage rapide

Voir [Démarrage rapide](/fr/api-reference/quickstart) pour une première requête `curl`.

OpenAPI : [`/openapi/scango.json`](/openapi/scango.json)