> ## 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.

# Błędy uwierzytelniania tokenem API

> Co zrobić, gdy wywołania API Zippendo z tokenem API są odrzucane z błędem 401 Unauthorized, 403 Forbidden lub 429 Too Many Requests.

Token API pozwala Twojemu własnemu systemowi lub skryptowi programisty pracować z Zippendo. Tokeny tworzysz w **Ustawienia** → **Ustawienia API** (otwórz menu organizacji i kliknij **Zarządzaj**). Jeśli wywołanie zostanie odrzucone, odpowiedź podaje powód.

## Co widzisz

* `401 Unauthorized` z `Invalid or expired token` lub `Authentication required`.
* `403 Forbidden` z `Missing required scope` lub **Nie masz dostępu do tej organizacji.**
* `429 Too Many Requests` z `API rate limit of … requests per minute reached.`
* Wywołanie działa w aplikacji Zippendo, ale nie działa z Twojego skryptu lub serwera.

## 401: token nie jest akceptowany

| Komunikat | Prawdopodobna przyczyna | Co zrobić |
| - | - | - |
| `Authentication required` | Nie wysłano tokena | Wyślij token w nagłówku `Authorization`, jak pokazano poniżej |
| `Invalid or expired token` | Token wpisano z błędem, obcięto, usunięto lub wygasł | Sprawdź token zgodnie z opisem poniżej. W razie wątpliwości utwórz nowy |
| `Invalid token type` | Wysłano coś innego niż token API, na przykład wartość skopiowaną z przeglądarki | Użyj tokena pokazanego po kliknięciu **Utwórz token** |

Wyślij token w ten sposób, ze słowem `Bearer` i jedną spacją przed nim:

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

Sprawdź, czy:

1. Token zaczyna się od `zipp_` i został skopiowany w całości, bez spacji i podziałów wiersza na końcu.
2. Token nadal istnieje w sekcji **Ustawienia API**. Usunięcie tokena zatrzymuje go natychmiast.
3. Token nie wygasł. Kolumna **Wygasa** pokazuje datę. Token utworzony bez **Wygasa za (dni)** nigdy nie wygasa.

Zippendo pokazuje token tylko raz, w oknie **Utworzono token API**. Jeśli już go nie masz, utwórz nowy token przyciskiem **Dodaj token API** i usuń stary. Zobacz [Utwórz token API](/docs/pl/how-to/create-an-api-token).

## 403: token nie ma zezwolenia na to

| Komunikat | Prawdopodobna przyczyna | Co zrobić |
| - | - | - |
| `Missing required scope`, a po nim nazwa uprawnienia, taka jak `write:shipments` | Token utworzono bez tego uprawnienia | Utwórz nowy token i zaznacz uprawnienie w polu **Uprawnienia \***. Kolumna **Uprawnienia** pokazuje, co może każdy token |
| **Nie masz dostępu do tej organizacji.** | Organizacja w adresie wywołania nie jest tą, do której należy token | Użyj organizacji, w której utworzono token, albo utwórz token w drugiej organizacji |
| **Ta funkcja nie jest dostępna w Twoim obecnym planie. Zmień plan, aby z niej korzystać.** | Funkcja, którą wywołano, nie wchodzi w skład Twojego planu | Zobacz [Rozliczenia i zużycie](/docs/pl/how-to/billing-and-usage) |

## 429: zbyt wiele wywołań

Każdy plan dopuszcza określoną liczbę wywołań API na minutę:

| Plan | Wywołania na minutę |
| - | - |
| Free | 10 |
| Standard | 60 |
| Growth | 200 |
| Pro | 1 000 |
| Enterprise | 100 000 |

Po przekroczeniu limitu odpowiedź brzmi `API rate limit of … requests per minute reached. Please retry in … s.` Nagłówek `Retry-After` podaje, ile sekund czekać. Poczekaj tyle, spróbuj ponownie i rozłóż wywołania w czasie. Więcej: [Limity żądań](/docs/api-reference/rate-limits).

## Nie możesz utworzyć kolejnego tokena

**Osiągnięto limit Twojego planu. Zmień plan albo usuń coś, czego już nie używasz.** oznacza, że wykorzystano liczbę tokenów API w Twoim planie: 2 w planie Free, 5 w planie Standard, 10 w planie Growth i bez limitu w planach Pro i Enterprise. Usuń token, którego już nie używasz, albo zmień plan.

## Dobre nawyki

* Trzymaj tokeny na swoim serwerze. Nigdy nie umieszczaj tokena na stronie sklepu internetowego ani w innym kodzie uruchamianym w przeglądarce klienta.
* Daj każdemu systemowi własny token, tylko z potrzebnymi uprawnieniami. Wtedy możesz usunąć jeden, nie zatrzymując pozostałych.

Powiązane: [Szybki start z REST API](/docs/pl/quickstarts/rest-api), [Ustawienia API](/docs/pl/settings/api-settings), [Przegląd API](/docs/api-reference/overview).


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