Skip to main content
W Ustawieniach API tworzysz Tokeny API. Token API pozwala Twoim własnym systemom lub programiście pracującemu dla Ciebie komunikować się bezpośrednio z Zippendo: tworzyć przesyłki, odczytywać zamówienia albo łączyć system magazynowy lub back office.

Gdzie to znaleźć

Otwórz menu organizacji na dole panelu bocznego, kliknij Zarządzaj, a potem kartę Ustawienia API. Zobaczysz swoje tokeny i przycisk Dodaj token API. Każdy plan obejmuje tokeny API: Free do 2, Standard 5, Growth 10, Pro i Enterprise bez limitu.

Utwórz token API

1

Otwórz okno

Kliknij Dodaj token API (albo Utwórz pierwszy token, jeśli lista jest pusta).
2

Nazwij token

Wpisz Nazwa tokena *, na przykład „Integracja WMS” lub „Back office”, aby później łatwo go rozpoznać. Możesz też ustawić Wygasa za (dni) (do 365) i, jeśli Twoja organizacja ma marki, Ogranicz do marki.
3

Wybierz uprawnienia

Zaznacz Uprawnienia *, których token potrzebuje, na przykład Wyświetlanie przesyłek i Edycja przesyłek.
4

Utwórz i skopiuj token

Kliknij Utwórz token. Pełny token jest pokazywany raz, w oknie Utworzono token API. Kliknij Kopiuj i zapisz go w bezpiecznym miejscu: po zamknięciu okna nie zobaczysz go ponownie.
Traktuj token API jak hasło. Nie udostępniaj go i nie umieszczaj w kodzie, który mogą zobaczyć inni. Jeśli token wycieknie, usuń go i utwórz nowy.

Używanie tokena

Twój programista wysyła token w nagłówku Authorization każdego zapytania: Authorization: Bearer YOUR_TOKEN Adres do wywołania i wszystkie zapytania znajdziesz w API reference. Token ma dostęp tylko do danych Twojej własnej organizacji.

Ograniczanie tokena do marki

Jeśli Twoja organizacja korzysta z marek, możesz ustawić Ogranicz do marki podczas tworzenia tokena. Każde zapytanie wykonane z tym tokenem może wtedy czytać i zapisywać tylko dane tej marki. Nie możesz później zmienić ani usunąć marki, więc jeśli potrzebujesz innej, utwórz nowy token. Token bez marki działa dla całej organizacji. Programista nadal może skierować pojedyncze zapytanie do jednej marki nagłówkiem X-Zippendo-Brand i ustawić wartość domyślną dla zapytań o listy nagłówkiem X-Zippendo-Brand-Scope (own, shared lub both). Zobacz Marki i API reference.

Usuwanie tokena

Aby token przestał działać, na przykład gdy integracja jest wycofywana lub token został ujawniony, kliknij Usuń w jego wierszu w Ustawieniach API. Wpisz nazwę tokena wielkimi literami i potwierdź. Każdy system używający tokena natychmiast przestaje działać; utwórz nowy token, jeśli ma dalej działać. Wszystkie pola szczegółowo: Utwórz token API.