Skip to main content
Mit einem API-Token können dein eigenes System oder das Skript einer Entwicklerin oder eines Entwicklers mit Zippendo arbeiten. Du erstellst Token unter Einstellungen → API-Einstellungen (öffne das Organisationsmenü und klicke auf Verwalten). Wird ein Aufruf abgelehnt, sagt die Antwort, warum.

​
Was du siehst

  • 401 Unauthorized mit Invalid or expired token oder Authentication required.
  • 403 Forbidden mit Missing required scope oder Du hast keinen Zugriff auf diese Organisation.
  • 429 Too Many Requests mit API rate limit of … requests per minute reached.
  • Der Aufruf funktioniert in der Zippendo-App, schlägt aber von deinem Skript oder Server aus fehl.

​
401: Der Token wird nicht akzeptiert

Sende den Token so, mit dem Wort Bearer und einem Leerzeichen davor:
Prüfe, ob
  1. der Token mit zipp_ beginnt und vollständig kopiert wurde, ohne Leerzeichen oder Zeilenumbrüche am Ende.
  2. der Token unter API-Einstellungen noch existiert. Wird ein Token gelöscht, stoppt er sofort.
  3. der Token nicht abgelaufen ist. Die Spalte Läuft ab zeigt das Datum. Ein Token, der ohne Läuft ab in (Tagen) erstellt wurde, läuft nie ab.
Zippendo zeigt einen Token nur einmal, unter API-Token erstellt. Hast du ihn nicht mehr, erstelle mit API-Token hinzufügen einen neuen Token und lösche den alten. Siehe Einen API-Token erstellen.

​
403: Der Token darf das nicht

​
429: zu viele Aufrufe

Jeder Tarif erlaubt eine bestimmte Anzahl von API-Aufrufen pro Minute: Überschreitest du das Limit, lautet die Antwort API rate limit of … requests per minute reached. Please retry in … s. Der Header Retry-After sagt, wie viele Sekunden du warten sollst. Warte so lange, versuche es dann noch einmal und verteile deine Aufrufe. Mehr dazu: Rate Limits.

​
Du kannst keinen weiteren Token erstellen

Du hast das Limit deines Tarifs erreicht. Upgrade deinen Tarif oder entferne etwas, das du nicht mehr brauchst. bedeutet, dass die Anzahl der API-Token deines Tarifs aufgebraucht ist: 2 im Tarif Free, 5 in Standard, 10 in Growth und kein Limit in Pro und Enterprise. Lösche einen Token, den du nicht mehr nutzt, oder upgrade.

​
Gute Gewohnheiten

  • Bewahre Token auf deinem Server auf. Setze einen Token nie in eine Seite deines Onlineshops oder anderen Code, der im Browser eines Kunden läuft.
  • Gib jedem System seinen eigenen Token, nur mit den Berechtigungen, die es braucht. Dann kannst du einen löschen, ohne die anderen zu stoppen.
Verwandt: Schnellstart REST API, API-Einstellungen, API-Überblick.