Zum Hauptinhalt springen
Um die API nutzen zu können, muss zuerst ein API-Key generiert werden. Dieser kann unter Einstellungen > Organisation > API Key erstellt werden.

​
Basis-URL

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

​
Authentifizierung

  • Typ: Bearer Token
  • Verwendung: Fügen Sie das Bearer Token in den Authorization-Header für alle Anfragen ein.

​
OpenAPI-Spezifikation

Die maschinenlesbare API-Definition liegt unter api-reference/openapi.json. Nutzen Sie sie mit OpenAPI-fähigen Tools, Codegeneratoren oder Assistenten.

​
Listen-Antworten (meta)

Jeder Listen-Endpunkt liefert data (das Array) und zusätzlich meta mit mindestens:
FeldBedeutung
totalBei Produktsuche mit q die geschätzte Trefferzahl des Suchindexes. Bei allen anderen Listen entspricht der Wert der Anzahl der in dieser Antwort gelieferten Einträge (wie returned).
returnedAnzahl der Einträge im Array data in dieser Antwort.
limitAngewendete Seitengröße aus dem Abfrageparameter limit (Standard 100, Maximum 5000). Bei Produktsuche mit q liegt die effektive Obergrenze bei 250.
Listen-Endpunkte unterstützen einen optionalen Abfrageparameter limit (Standard 100, Maximum 5000). Bei Produktsuche mit q enthält meta außerdem offset für die Paginierung.

​
API-Struktur

Die Scango API bietet Zugriff auf folgende Hauptressourcen:

Agent-Rezepte

Schritt-für-Schritt-Abläufe für Automation und KI-Assistenten

Produkte

Verwalten Sie Ihren Produktkatalog

Bestellungen

Greifen Sie auf Bestellinformationen zu

Lieferanten

Sehen Sie Lieferantendetails ein

Kategorien

Durchsuchen Sie Produktkategorien

​
Wichtige Hinweise

Aktuell können Produktbilder nicht über die API hochgeladen werden.
Webhooks sind noch nicht verfügbar. Wir empfehlen, in gewünschten Intervallen nach neuen Bestellungen zu prüfen.