Szybki start z REST API

REST API pozwala Twoim własnym systemom współpracować z Zippendo bezpośrednio, dzięki czemu Twój sklep internetowy, ERP lub system magazynowy może tworzyć przesyłki, odczytywać zamówienia i pobierać etykiety bez otwierania aplikacji. Każdy publiczny endpoint jest wymieniony na karcie API reference, razem z playgroundem do wypróbowywania zapytań.

1. Utwórz token API

Otwórz Ustawienia API

W app.zippendo.com otwórz menu organizacji na dole panelu bocznego, kliknij Zarządzaj, a potem Ustawienia API.

Utwórz token

Kliknij Dodaj token API, nadaj mu nazwę (na przykład Production WMS), zaznacz potrzebne Uprawnienia i kliknij Utwórz token. Skopiuj token od razu: jest pokazywany tylko raz.

Przechowuj go bezpiecznie

Tokeny API zaczynają się od zipp_. Traktuj je jak hasła: trzymaj je w zmiennych środowiskowych, nigdy w repozytorium kodu.

Uprawnienia, wygasanie, ograniczenie do marki i usuwanie tokenów opisano w Ustawienia API.

2. Znajdź ID swojej organizacji

Każdy endpoint przyjmuje ID Twojej organizacji (orgId) w ścieżce. Zapytaj Zippendo, do której organizacji należy Twój token:

curl -X POST https://api.zippendo.com/api-tokens/verify \
  -H "Content-Type: application/json" \
  -d '{ "token": "zipp_YOUR_TOKEN" }'

Odpowiedź zawiera orgId, a także scopes i expiresAt tokena.

3. Wykonaj pierwsze zapytanie

Przesyłaj token jako dane uwierzytelniające Bearer w każdym zapytaniu:

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

Zastąp {orgId} ID z kroku 2. Token potrzebuje do tego wywołania uprawnienia read:shipments.

Nigdy nie umieszczaj tokenów API w kodzie uruchamianym w przeglądarce ani w aplikacji mobilnej. Wywołuj Zippendo ze swojego backendu.

Wolisz typowanego klienta? Bezpłatne SDK dla TypeScript, Python, PHP, Go i Ruby obejmują każdy endpoint, więc możesz pominąć surowe HTTP.

Każdy plan ma limit zapytań na minutę. Zobacz Limity zapytań.

4. Poznaj endpointy

Publiczne API obejmuje:

Obszar	Typowe zastosowanie
Przesyłki	Tworzenie, wysyłanie, dzielenie i śledzenie przesyłek; pobieranie etykiet i dokumentów
Zamówienia	Tworzenie zamówień i odczyt zamówień zaimportowanych przez Twoje kanały sprzedaży
Kanały sprzedaży	Zarządzanie własnymi kanałami dla Twojego sklepu internetowego lub ERP
Przewoźnicy	Łączenie przewoźników, wyświetlanie ich produktów i wyszukiwanie punktów odbioru
Wycena wysyłki	Ceny z Twoich reguł wysyłki dla koszyka w kasie
Reguły wysyłki	Odczyt i zarządzanie regułami wysyłki
Webhooki	Powiadomienia o zmianach przesyłek, zamówień i śledzenia
Adresy	Zarządzanie adresami nadawcy, odbioru i zwrotu

Otwórz API reference, aby przeglądać ścieżki i treści zapytań oraz wypróbowywać zapytania w playgroundzie.

Kolejne kroki

Szybki start z webhookami

Wysyłaj zdarzenia na swój serwer, gdy dane się zmieniają.

Wyceny wysyłki

Pokaż ceny wysyłki dla koszyka w kasie.

Serwer MCP

Pozwól, aby Claude, Cursor lub ChatGPT pracowały w Zippendo za Ciebie.

Własne kanały

Wysyłaj zamówienia z własnego sklepu internetowego lub ERP do Zippendo.

Start

Szybki start

Przepływ realizacji zamówień

Połączenia

Operacje

Organizacja i konto

Szybki start z REST API

1. Utwórz token API

2. Znajdź ID swojej organizacji

3. Wykonaj pierwsze zapytanie

4. Poznaj endpointy

Kolejne kroki

Szybki start z webhookami

Wyceny wysyłki

Serwer MCP

Własne kanały

​1. Utwórz token API

​2. Znajdź ID swojej organizacji

​3. Wykonaj pierwsze zapytanie

​4. Poznaj endpointy

​Kolejne kroki

Szybki start z webhookami

Wyceny wysyłki

Serwer MCP

Własne kanały

1. Utwórz token API

2. Znajdź ID swojej organizacji

3. Wykonaj pierwsze zapytanie

4. Poznaj endpointy

Kolejne kroki