Zum Inhalt springen
scango.ch
Deutsch
Esc
navigierenöffnen⌘JVorschau
Auf dieser Seite

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 }. 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
  • Kein Bild-Upload über die API

Schnellstart

Siehe Schnellstart für den ersten curl-Aufruf.

OpenAPI: /openapi/scango.json

War diese Seite hilfreich?