---
title: 'Einführung'
description: 'scango.ch Kunden-API'
---

REST-API für Integrationen: Produkte, Bestellungen, Lieferanten, Kategorien und Filialen.

### Basis-URL

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

### Authentifizierung

API-Schlüssel unter **Einstellungen → Organisation → Schlüssel**:

```http
Authorization: Bearer <api-key>
```

- **Lesen** — GET
- **Schreiben** — zusätzlich Produkte, Kategorien, Lieferanten und Filialen anlegen, aktualisieren und löschen

### Wichtige Regeln

- Geldbeträge sind **Ganzzahlen in Rappen** (`120` = CHF 1.20)
- Listen liefern `{ data, meta }`. Parameter `limit` (Standard 100, max. 5000)
- `offset` gibt es nur bei Produktsuche mit `q` (max. 250 pro Seite)
- Ohne `q`: mit optionalem `cursor` paginieren; `meta.nextCursor` folgen, bis es fehlt. Soft-gelöschte Katalogeinträge fehlen in Listen — `returned < limit` bedeutet nicht automatisch Ende; weiter paginieren, solange `nextCursor` gesetzt ist
- Bestellungen: `start`, `end` und `paymentState` sind Pflicht; `cursor` beim Auflisten von Bestellungen gleich verwenden
- Keine Webhooks — Bestellungen pollen
- Produktbilder: `imageUrl` bei Create/Update setzen oder `POST /products/{productId}/image` (multipart `file`); löschen mit `DELETE /products/{productId}/image`

### Schnellstart

Siehe [Schnellstart](/api-reference/quickstart) für den ersten `curl`-Aufruf.

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