Utwórz token API

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. Tokeny tworzysz w sekcji Ustawienia API. Zippendo pokazuje pełny token tylko raz, zaraz po jego utworzeniu. Przegląd Ustawień: Ustawienia, zespół i marki. Pierwsze żądanie: Szybki start z REST API. Ceny wysyłki w koszyku: Pobierz wycenę wysyłki.

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.

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.

Karta Ustawienia API z listą tokenów API i przyciskiem Dodaj token API w nagłówku — Tokeny API: nazwa, początek każdego tokena, uprawnienia i ostatnie użycie

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

Otwórz okno

Kliknij Dodaj token API albo Utwórz pierwszy token, gdy lista jest pusta. Otworzy się okno Utwórz token API.

Nazwij token

Wypełnij Nazwa tokena *, na przykład „Warehouse WMS”. Opcjonalnie ustaw Wygasa za (dni) i Ogranicz do marki.

Wybierz uprawnienia

Zaznacz, co token może robić, albo kliknij Zaznacz wszystkie.

Utwórz go

Kliknij Utwórz token. Zobaczysz Utworzono token API, a okno Utworzono token API otworzy się z pełnym tokenem.

Okno Utwórz token API z polami Nazwa tokena, Wygasa za (dni) i polami wyboru uprawnień — Utwórz token API: nazwa, opcjonalny termin ważności, potem uprawnienia

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

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

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

Okno Utworzono token API z tokenem, przyciskiem Kopiuj i ostrzeżeniem Ważne — Utworzono token API: skopiuj token, zanim zamkniesz okno

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.

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.

Użyj tokena

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

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, gdzie opisano każde żądanie i odpowiedź. Gotowi klienci: SDK. Limity: Limity żądań. 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.

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.

Okno Usunąć token API? z polem do wpisania nazwy w celu potwierdzenia — Usunąć token API?: wpisz nazwę wielkimi literami, aby potwierdzić

Powiązane

Webhooki: Zippendo informuje Twój system, gdy coś się dzieje, zamiast Twojego systemu pytającego o to.
Połącz Slack, Klaviyo i inne aplikacje: gotowe połączenia, które nie wymagają tokena API.
API własnego kanału: przesyłaj zamówienia z własnego sklepu lub systemu do Zippendo.
Pobierz wycenę wysyłki: ceny wysyłki w koszyku.
Uwierzytelnianie MCP: połącz agenta AI bez wklejania tokena.

Przegląd

Przesyłki

Zamówienia i kanały

Przewoźnicy

Połącz przewoźnika

Połącz integrację

Drukowanie

Automatyzacja

Konto

Wyszukiwanie i panel

API i zdarzenia

Utwórz token API

Gdzie to znaleźć

Lista tokenów API

Utwórz token

Uprawnienia

Skopiuj token (tylko raz)

Użyj tokena

Usuń token

Powiązane

​Gdzie to znaleźć

​Lista tokenów API

​Utwórz token

​Uprawnienia

​Skopiuj token (tylko raz)

​Użyj tokena

​Usuń token

​Powiązane

Gdzie to znaleźć

Lista tokenów API

Utwórz token

Uprawnienia

Skopiuj token (tylko raz)

Użyj tokena

Usuń token

Powiązane