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

# Utwórz token API

> Utwórz token API w Ustawienia → Ustawienia API, aby Twoje własne systemy mogły łączyć się z Zippendo - nazwa, termin ważności, uprawnienia, jednorazowe skopiowanie tokena i jego usunięcie.

**Token API** pozwala Twoim własnym systemom lub programiście pracującemu dla Ciebie połączyć się z Zippendo: tworzyć przesyłki, odczytywać zamówienia, rejestrować webhooki i robić wszystko inne opisane w [dokumentacji API](/docs/api-reference/overview). Tokeny tworzysz w sekcji **Ustawienia API**. Zippendo pokazuje pełny token tylko raz, zaraz po jego utworzeniu.

Przegląd Ustawień: [Ustawienia, zespół i marki](/docs/pl/tutorials/settings-team-brands). Pierwsze żądanie: [Szybki start z REST API](/docs/pl/quickstarts/rest-api). Ceny wysyłki w koszyku: [Pobierz wycenę wysyłki](/docs/pl/how-to/shipping-quotes).

<Info>
  Każdy plan obejmuje tokeny API: Free do 2, Standard 5, Growth 10, Pro i Enterprise bez limitu. Po osiągnięciu limitu utworzenie tokena kończy się komunikatem **Osiągnięto limit Twojego planu. Zmień plan albo usuń coś, czego już nie używasz.** Usuń token, którego już nie używasz, albo zmień plan.
</Info>

## Gdzie to znaleźć

Otwórz menu organizacji na dole paska bocznego, kliknij **Zarządzaj**, a następnie kartę **Ustawienia API**. Przycisk do tworzenia tokena to **Dodaj token API** w prawym górnym rogu.

<Frame caption="Tokeny API: nazwa, początek każdego tokena, uprawnienia i ostatnie użycie">
  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/01-api-settings-light.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=65902fe13df28b3e873d556844126bd2" alt="Karta Ustawienia API z listą tokenów API i przyciskiem Dodaj token API w nagłówku" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/create-an-api-token/01-api-settings-light.png" />

  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/01-api-settings-dark.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=0ebc61d4169d8abcfe0da400edbce30e" alt="Karta Ustawienia API z listą tokenów API i przyciskiem Dodaj token API w nagłówku" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/create-an-api-token/01-api-settings-dark.png" />
</Frame>

## Lista tokenów API

| Kolumna | Co pokazuje |
| - | - |
| **Nazwa** | Wpisana przez Ciebie **Nazwa tokena**. |
| **Token** | Pierwsze znaki tokena, a po nich `...`. Pełny token nigdy tu nie jest pokazywany. |
| **Uprawnienia** | Do trzech uprawnień, takich jak **Wyświetlanie przesyłek**; pozostałe są zwinięte. **Brak uprawnień**, jeśli żadnych nie wybrano. |
| **Ostatnio użyty** | Kiedy token był ostatnio używany, albo **Nigdy**. |
| **Utworzona przez** | Członek zespołu, który go utworzył. |
| **Wygasa** | Data wygaśnięcia albo **Nigdy**. Data z przeszłości jest pokazana na czerwono. |
| **Utworzono** | Kiedy został utworzony. |

Jedyne, co możesz zrobić z tokenem na liście, to go **Usuń**. Nie możesz edytować tokena ani zmienić jego nazwy.

Gdy nie ma jeszcze tokenów, lista pokazuje **Brak tokenów API** i przycisk **Utwórz pierwszy token**.

## Utwórz token

<Steps>
  <Step title="Otwórz okno">
    Kliknij **Dodaj token API** albo **Utwórz pierwszy token**, gdy lista jest pusta. Otworzy się okno **Utwórz token API**.
  </Step>

  <Step title="Nazwij token">
    Wypełnij **Nazwa tokena \***, na przykład „Warehouse WMS”. Opcjonalnie ustaw **Wygasa za (dni)** i **Ogranicz do marki**.
  </Step>

  <Step title="Wybierz uprawnienia">
    Zaznacz, co token może robić, albo kliknij **Zaznacz wszystkie**.
  </Step>

  <Step title="Utwórz go">
    Kliknij **Utwórz token**. Zobaczysz **Utworzono token API**, a okno **Utworzono token API** otworzy się z pełnym tokenem.
  </Step>
</Steps>

<Frame caption="Utwórz token API: nazwa, opcjonalny termin ważności, potem uprawnienia">
  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/02-create-modal-light.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=32f95614e60ec8c3cb5882b9f05df608" alt="Okno Utwórz token API z polami Nazwa tokena, Wygasa za (dni) i polami wyboru uprawnień" className="block dark:hidden" width="2880" height="2800" data-path="images/pl/how-to/create-an-api-token/02-create-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/02-create-modal-dark.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=32e73800272ae7e5f0b45b518604a0f5" alt="Okno Utwórz token API z polami Nazwa tokena, Wygasa za (dni) i polami wyboru uprawnień" className="hidden dark:block" width="2880" height="2800" data-path="images/pl/how-to/create-an-api-token/02-create-modal-dark.png" />
</Frame>

| Pole | Wymagane | Co wpisać |
| - | - | - |
| **Nazwa tokena \*** | Tak | Nazwa, która mówi, gdzie token jest używany, na przykład „Production API” lub „Webhook Service”. Do 100 znaków. |
| **Ogranicz do marki** | Nie | Widoczne tylko wtedy, gdy Twoja organizacja ma [marki](/docs/pl/how-to/create-a-brand). Wybierz markę, a **Aplikacje i systemy używające tego tokena widzą i zmieniają tylko dane tej marki.** Domyślnie **Brak marki (cała organizacja)**. Nie możesz tego później zmienić. |
| **Wygasa za (dni)** | Nie | Liczba od 1 do 365. Token przestaje działać po tylu dniach. Zostaw puste dla tokena, który nigdy nie wygasa. |
| **Uprawnienia \*** | Tak, co najmniej jedno | Co token może odczytywać i zmieniać. Zobacz listę poniżej. |

**Utwórz token** pozostaje wyszarzone, dopóki token nie ma nazwy i co najmniej jednego uprawnienia.

### Uprawnienia

Każdy obszar ma uprawnienie **Odczyt** (**Wyświetlanie i odczyt informacji**) i uprawnienie **Zapis** (**Tworzenie, aktualizowanie i usuwanie**). Uprawnienie **Zapis** obejmuje **Odczyt** w tym samym obszarze.

<Frame caption="Wszystkie uprawnienia, z włączonym Zaznacz wszystkie">
  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/03-permissions-light.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=d887465ba81ac53bb1ce40a664828dfa" alt="Uprawnienia w oknie Utwórz token API z polami Odczyt i Zapis, w tym Wyświetlanie wszystkiego i Edycja wszystkiego" className="block dark:hidden" width="2880" height="2800" data-path="images/pl/how-to/create-an-api-token/03-permissions-light.png" />

  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/03-permissions-dark.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=97e1d8e2f2aaf9664458ccbb5800123d" alt="Uprawnienia w oknie Utwórz token API z polami Odczyt i Zapis, w tym Wyświetlanie wszystkiego i Edycja wszystkiego" className="hidden dark:block" width="2880" height="2800" data-path="images/pl/how-to/create-an-api-token/03-permissions-dark.png" />
</Frame>

| Uprawnienie | Obejmuje |
| - | - |
| **Wyświetlanie przesyłek** / **Edycja przesyłek** | Przesyłki |
| **Wyświetlanie reguł wysyłki** / **Edycja reguł wysyłki** | Reguły wysyłki oraz [wyceny wysyłki](/docs/pl/how-to/shipping-quotes) |
| **Wyświetlanie przewoźników** / **Edycja przewoźników** | Połączeni przewoźnicy |
| **Wyświetlanie adresów** / **Edycja adresów** | Adresy nadawcy |
| **Wyświetlanie organizacji** / **Edycja organizacji** | Dane Twojej organizacji |
| **Wyświetlanie członków zespołu** / **Edycja członków zespołu** | Członkowie zespołu |
| **Wyświetlanie tokenów API** / **Edycja tokenów API** | Pozostałe tokeny API |
| **Wyświetlanie wszystkiego** / **Edycja wszystkiego** | Wszystko powyżej oprócz tokenów API oraz zamówienia, kanały sprzedaży, drukarki, webhooki, automatyzacje, integracje i role |

Zamówienia, kanały sprzedaży, drukarki, webhooki, automatyzacje i integracje nie mają własnego uprawnienia: token, który ich potrzebuje, musi mieć **Wyświetlanie wszystkiego** lub **Edycja wszystkiego**. Żadne z nich nie obejmuje tokenów API, więc zaznacz także **Edycja tokenów API**, jeśli token ma tworzyć lub usuwać inne tokeny. Te same uprawnienia są używane dla [własnych ról](/docs/pl/how-to/roles-and-permissions).

## Skopiuj token (tylko raz)

Okno **Utworzono token API** pokazuje pełny token, który zaczyna się od `zipp_`. Okno ostrzega: **Koniecznie skopiuj ten token. Po zamknięciu tego okna nie będzie można go ponownie zobaczyć.**

<Frame caption="Utworzono token API: skopiuj token, zanim zamkniesz okno">
  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/04-token-secret-light.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=b38e7f2b0adae11fa931fff51e3f6dfc" alt="Okno Utworzono token API z tokenem, przyciskiem Kopiuj i ostrzeżeniem Ważne" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/create-an-api-token/04-token-secret-light.png" />

  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/04-token-secret-dark.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=e89e44becd911d334948cdf0406d5a76" alt="Okno Utworzono token API z tokenem, przyciskiem Kopiuj i ostrzeżeniem Ważne" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/create-an-api-token/04-token-secret-dark.png" />
</Frame>

Kliknij **Kopiuj**. Zobaczysz **Skopiowano token do schowka**. Jeśli zobaczysz **Nie udało się skopiować tokena**, zaznacz token i skopiuj go ręcznie. Potem zamknij okno. Jeśli zgubisz token, usuń go i utwórz nowy.

<Warning>
  Traktuj token jak hasło. Nie umieszczaj go w kodzie, który mogą zobaczyć inni, ani na stronie internetowej. Jeśli wycieknie, usuń go (zobacz „Usuń token” poniżej) i utwórz nowy. Żądania, które się nie udają: [Błędy uwierzytelniania tokenem API](/docs/pl/knowledge-base/api-token-authentication-errors).
</Warning>

## Użyj tokena

Twój programista wysyła token z każdym żądaniem:

```bash theme={null}
curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"
```

`{orgId}` to identyfikator Twojej organizacji, a nie nazwa z paska adresu aplikacji. Programista może go wyświetlić za pomocą żądań Orgs w [dokumentacji API](/docs/api-reference/overview), gdzie opisano każde żądanie i odpowiedź. Gotowi klienci: [SDK](/docs/pl/sdks/overview). Limity: [Limity żądań](/docs/api-reference/rate-limits).

Token bez marki może skierować pojedyncze żądanie do jednej marki za pomocą nagłówka `X-Zippendo-Brand`. Token utworzony z opcją **Ogranicz do marki** zawsze pozostaje w obrębie swojej marki. Zobacz [Marki](/docs/pl/settings/brands).

## Usuń token

Kliknij **Usuń** w wierszu tokena. Okno **Usunąć token API?** prosi o wpisanie nazwy tokena wielkimi literami, na przykład `WAREHOUSE WMS`, a następnie kliknij **Usuń**. Zobaczysz **Usunięto token API**. Każdy system używający tokena nie może się już połączyć. Usunięcia nie można cofnąć i nie ma możliwości wstrzymania tokena zamiast tego.

<Frame caption="Usunąć token API?: wpisz nazwę wielkimi literami, aby potwierdzić">
  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/05-delete-token-light.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=93a0909460b6c5a34dcc51bff227c803" alt="Okno Usunąć token API? z polem do wpisania nazwy w celu potwierdzenia" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/create-an-api-token/05-delete-token-light.png" />

  <img src="https://mintcdn.com/zippendo/5dxPBCmSwM7RFSTw/images/pl/how-to/create-an-api-token/05-delete-token-dark.png?fit=max&auto=format&n=5dxPBCmSwM7RFSTw&q=85&s=e4cd192b970ef5c3d9b02bba4eb348cf" alt="Okno Usunąć token API? z polem do wpisania nazwy w celu potwierdzenia" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/create-an-api-token/05-delete-token-dark.png" />
</Frame>

## Powiązane

* [Webhooki](/docs/pl/how-to/webhooks): Zippendo informuje Twój system, gdy coś się dzieje, zamiast Twojego systemu pytającego o to.
* [Połącz Slack, Klaviyo i inne aplikacje](/docs/pl/how-to/connect-an-integration): gotowe połączenia, które nie wymagają tokena API.
* [API własnego kanału](/docs/pl/how-to/custom-channel-api): przesyłaj zamówienia z własnego sklepu lub systemu do Zippendo.
* [Pobierz wycenę wysyłki](/docs/pl/how-to/shipping-quotes): ceny wysyłki w koszyku.
* [Uwierzytelnianie MCP](/docs/pl/mcp/authentication): połącz agenta AI bez wklejania tokena.


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