Einführung
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:
Autorisierung: 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 }. Parameterlimit(Standard 100, max. 5000) offsetgibt es nur bei Produktsuche mitq(max. 250 pro Seite)- Ohne
q: mit optionalemcursorpaginieren;meta.nextCursorfolgen, bis es fehlt. Soft-gelöschte Katalogeinträge fehlen in Listen —returned < limitbedeutet nicht automatisch Ende; weiter paginieren, solangenextCursorgesetzt ist - Bestellungen:
start,endundpaymentStatesind Pflicht;cursorbeim Auflisten von Bestellungen gleich verwenden - Keine Webhooks — Bestellungen pollen
- Kein Bild-Upload über die API
Schnellstart
Siehe Schnellstart für den ersten curl-Aufruf.
OpenAPI: /openapi/scango.json