> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentifizierungsfehler bei API-Token

> Was zu tun ist, wenn Aufrufe der Zippendo-API mit einem API-Token mit 401 Unauthorized, 403 Forbidden oder 429 Too Many Requests abgelehnt werden.

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

| Meldung | Wahrscheinliche Ursache | Was zu tun ist |
| - | - | - |
| `Authentication required` | Es wurde kein Token gesendet | Sende den Token im Header `Authorization`, wie unten gezeigt |
| `Invalid or expired token` | Der Token wurde falsch eingetippt, abgeschnitten, gelöscht oder ist abgelaufen | Prüfe den Token wie unten beschrieben. Im Zweifel erstelle einen neuen |
| `Invalid token type` | Es wurde etwas anderes als ein API-Token gesendet, zum Beispiel ein aus dem Browser kopierter Wert | Nutze den Token, der beim Klick auf **Token erstellen** angezeigt wurde |

Sende den Token so, mit dem Wort `Bearer` und einem Leerzeichen davor:

```bash theme={null}
Authorization: Bearer zipp_YOUR_TOKEN
```

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](/docs/de/how-to/create-an-api-token).

## 403: Der Token darf das nicht

| Meldung | Wahrscheinliche Ursache | Was zu tun ist |
| - | - | - |
| `Missing required scope`, gefolgt von einem Berechtigungsnamen wie `write:shipments` | Der Token wurde ohne diese Berechtigung erstellt | Erstelle einen neuen Token und aktiviere die Berechtigung unter **Berechtigungen \***. Die Spalte **Berechtigungen** zeigt, was jeder Token darf |
| **Du hast keinen Zugriff auf diese Organisation.** | Die Organisation in der Adresse des Aufrufs ist nicht die, zu der der Token gehört | Nutze die Organisation, in der der Token erstellt wurde, oder erstelle einen Token in der anderen Organisation |
| **Diese Funktion ist in deinem aktuellen Tarif nicht enthalten. Upgrade deinen Tarif, um sie zu nutzen.** | Die aufgerufene Funktion gehört nicht zu deinem Tarif | Siehe [Abrechnung und Nutzung](/docs/de/how-to/billing-and-usage) |

## 429: zu viele Aufrufe

Jeder Tarif erlaubt eine bestimmte Anzahl von API-Aufrufen pro Minute:

| Tarif | Aufrufe pro Minute |
| - | - |
| Free | 10 |
| Standard | 60 |
| Growth | 200 |
| Pro | 1,000 |
| Enterprise | 100,000 |

Ü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](/docs/api-reference/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](/docs/de/quickstarts/rest-api), [API-Einstellungen](/docs/de/settings/api-settings), [API-Überblick](/docs/api-reference/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.